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WELCOME TO 
THE OFFICIAL 
MAGAZINE 


e’re always amazed by what the 
Raspberry Pi community builds using 
the Pi Zero W (Raspberry Pi’s smallest 
wireless computer). We’ve seen miniature game 
consoles, photo frames, magic mirrors (plus other 
small display projects), drones, tiny robots, and 
smart devices around the home. The Pi Zero W is 
small, cheap, sturdy and, crucially, incredibly well gt 
engineered. No wonder it’s so popular. ay a 2g" * a Soe 
But Raspberry Pi isn’t the only platform out 3 Sout == 
there. Another board that’s often used by digital 
makers is Arduino. People often think of Pi and 
Arduino as rivals, but they are very different 
devices. Raspberry Pi is a computer platform, while 
Arduino is a microcontroller, ideal for controlling SEE PAGE 28 FOR DETAILS 
precision elements like servos and DC motors. 
Putting the two together creates an unstoppable 
tag team. You get more done if you stop thinking 


about which widget is best, and start thinking THIS MONTH: 
about how components could work together to get 
the best result. 

That’s why this month we’ve got two incredible 16 PI ZERO PROJECTS YOU MUsT MAKE 
features: 10 Pi Zero W Projects, plus Arduino and Pi. TENICMIG aCe hecho picectonyouso nun 
Read both features and you’!l be capable of building 30 GOOGLE ALY INTERCOM 


bigger, better, and bolder projects. Never limit CiesiavanreumicneCeoe An 
yourself to just one approach, device, or project. 
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The more tools you can use, the better a digital 34 SMARTER DJ DECKS 
maker you’ll become. Digital music can't be scratched - or can it? 
Lucy Hattersley 60 ARDUINO AND PI 

Editor - The MagPi An unstoppable digital making team! 
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News 


TEN MILLIONTH 


FEATURE 


RASPBERRY Pl 
MADE IN WALES 


British Raspberry Pi manufacturing proves hugely successful 


Right Eben and the 
team at Sony UK 
TEC celebrating 
the landmark 

ten millionth 
Welsh-made Pi 


he Sony UK Technology 
Centre (Sony UK TEC) has 
announced the production 
of the ten millionth Raspberry Pi 
made in the UK. 

Raspberry Pis were originally 
made in China, but in 2012 Sony 
UK TEC was contracted to make 
10,000 units. However, a Sony UK 
TEC spokesperson confirmed that 
the facility “went on to produce 
one million [Raspberry Pi boards] 
in its first year.” 

Steve Dalton, Sony UK TEC 
managing director, said, “The last 
five years have seen unprecedented 
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erowth across our Pencoed 
facility - something we are 
understandably proud of.” 

The Pencoed facility was chosen, 
a Sony UK TEC spokesperson 
explained, “due to the facility’s 
capacity and innovative automated 
processes.” Based roughly 13 miles 
west of Cardiff, the Sony UK TEC 
facility “has seen staff numbers 
leap by 200, taking its team of local 
employees to 540” over the last 
five years. 

Steve added, “Our growth has 
been intrinsically linked to the 
success of the Raspberry Pi. This 


is a Significant achievement 
for everyone involved in its 
production, especially our devoted 
Sony Team, The Raspberry Pi 
Foundation, and distributors 
Premier Farnell.” 

Raspberry Pi co-founder 
Eben Upton joined Sony UK 
TEC to celebrate the milestone, 
saying “when we initially began 
manufacturing [Raspberry Pis] 
here at Sony UK TEC, we could 
never have imagined it would be 
the soaring success it has become — 
and for that we are grateful to Sony 
and our distribution partners.” 


raspberrypi.org/magpi 


PIS IN MILLIONS 


Made In Britain... Sony with Romain Soreau from RS and 


Gareth Jones and Joe Whaley from 
in Japa n? Sarah Fawcett from Premier Farnell ; | | 
Eben attributes much of the develop new processes and drive , Y 
success of the Raspberry Pi to innovation. We were able to support 
Sony UK TEC’s “unparalleled The Raspberry Pi Foundation 
manufacturing standards, further by introducing Pi 


Our growth has been 
intrinsically linked to the 
success of the Raspberry P1 


comprising the latest manufacturing to our counterparts 
techniques and the very best in Japan, and there is now a ‘made 
engineering talent.” in Japan’ version of Pi.” 


Steve Dalton added that making 
Raspberry Pis in such volume “has No Raspberry Pi 4 yet, 
challenged our highly skilledteam though 
of engineers and technicians to Speaking with Beta News 
(betanews.com) at a separate 
event, Eben was asked whether we 
might see a Raspberry Pi Model 4 
sometime soon. His response 
was, “Nope!” 

Eben clarified: “I think we gave 
the impression by launching Pi 2 
and Pi3 a year apart that we were 
establishing some sort of annual 
cadence. We’ve said that we think 
the Raspberry Pi 3 is more of a 
three-year platform.” 

Even that is a very soft timeline, 
though, as Eben added, “we’re not 
much more than a year into that 
(very rough) window yet.” 


Eben (left) with Steve Dalton, 
Sony UK TEC managing director 


: 
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/'(2T0 MINI MAKER FAIRE AT THE INSTITUTE OF IMAGINATION 


MINI MAKER 
rAIRE Al THE 
INSTITUTE OF 


IMAGINATION 


Fuelling kids’ imaginations with a full head of STEAM 


ondon-based charity, the 
Institute of Imagination 
(lol, www.ioi.london) 
hosted a Mini Maker Faire at its 
Imagination Lab on 29 July. 

The event featured activities 
from retro computing and 
laser cutting to robot football. 
We caught up with Corrie Jones, 
IoI interim marketing manager, 


One child had created a robot that 
would pick up all the rubbish from 
the bottom of the ocean 


Below Each 
SoccerBotz houses 
a Raspberry Pi and 
an Arduino 


ee 


after the show. “We’re really 
happy to have had so many 
people attend, and to see so many 
children get so involved in all of 
the activities,” she told us. 
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“Our current theme is ‘Teaching 
Me’, and is all about inventing 
things that you think will make a 
positive impact in the future. One 
child that I spoke to had created 
a robot that would pick up all the 
rubbish from the bottom of the 
ocean. Inventions [like that] show 
a really high level of thinking 
about what we need to improve 
the world.” 


Pi-powered robot football 
Red Robotics (redrobotics.co.uk) 
brought some SoccerBotz to make 

a three-a-side Pi-powered robot 
football game. “That was brilliant,” 
remarks Corrie. “I didn’t get to 
have a go on it myself because it 
was so busy throughout the day!” 


Above RedRobotics’ SoccerBotz were a hit 
at the lol's Mini Maker Faire 


The SoccerBotz used a Pi to handle 
the remote-control instructions and 
motors, but also used an Arduino to 
run the power control system. The 
Arduino can be programmed directly 
from the Pi, as we explain in our 
euide starting on page 60. 


STEAM power 


lol focuses on STEAM learning, 
adding art and design to science, 
technology, engineering, and 
maths. So, “as well as there being 
science and technology elements,” 
to IoI events, Corrie says, “the arts 
and things that [kids] can make and 
feel really proud of” also feature. 
The IoI runs many weekend 
activities, all aimed at children, 
families, schools and teachers, 
and covering everything from 
film-making to coding and 3D 
design. Visit 101.london/whats-on 
for details, or contact the Iol at 
hello@ioi.london to bring an 
‘Imagination Pod’ to your school. 
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Wireless Wireless microSD card WD PiDrive WD PiDrive Raspberry Pi 3 5V 3A Black Square 
Keyboard Mouse with preloaded Cable Foundation Power Supply 6x6" Enclosure 
software Edition 375GB and USB Cable 


VWITH WD PIDRIVE COMPUTE CENTRE 


Includes custom NOOBS, Raspbian PIXEL, and Raspbian Lite on a bundled 
SD card. Organize multiple projects in one place with Project Spaces and 
easily assemble components in a custom enclosure. 


@ WD LABS Learn more at wdlabs.io/mp60a 


of the Raspberry Pi Foundation, microSD is a trademark of SD-3C, LLC, All other marks are the property of their respective owners. As used for storage capacity, one gigabyte = one billion bytes. Total accessible capacity varies 
depending on operating environment. Product specifications subject to change without notice. Pictures shown may vary from actual product. © 2017 Western Digital Corporation or its affiliates. 
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ZEROCAM RELEASED 


A bespoke Pi Zero camera range 


he Pi Hut (thepihut.com) 
has released the first full 
range of cameras designed 
specifically for the Pi Zero. The 
cameras are smaller than the 
standard official Raspberry Pi 
Camera Modules, and connect 
directly to the smaller CSI ports 
of the Zero boards. 

The range includes a standard 
camera, a fish-eye camera, and 


Below 

Each ZeroCam 
comes in a metallic 
case with magnetic 
clasp - sounds like 
a body cam case 
to us! 


Zer@Cam 


& PiHut 


ANNOUNCED 


Who ‘Made it Outdoors’ the best? 


he winners of the second 
Pioneers challenge, 

a digital making projgram 
LOT 11-16 year-olds, have 

been announced. 

The overall theme winner is HH 
Squared’s Pi Spy project. 

Pioneers challenges young 
people to work together to create 
a piece of technology addressing 
a theme, with this cycle’s theme 
being ‘Make It Outdoors’. 
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a NOIR infrared camera. Despite 
the module’s reduced size of 
just 11.4*11.4 mm (compared to 
the 25x23 mm of the standard 
Module), it still packs a5MP sensor 
(compared to the 8MP of the V2 
Camera Module). 

The Pi Hut’s Jamie Mann tells 
us, “We sampled a bunch [of 
camera modules] from various 
manufacturers, found the best 
factory for the job and created 
the ZeroCam brand.” 


Right The ZeroCam 
is designed to fit 
the reduced-size 
camera connector 
on the Pi Zero 


The next Pioneers 
challenge will be 
set in September 


Pioneers organiser Oly Brown 
says of HH Squared’s project, 
“We really loved how every 
member of the team contributed 
[and] how tech was used to 
enhance the enjoyment of 
the outdoors.” 

The Pioneers challenge isn’t 
just about making something, 
but the process of trying to make 
something. Coding Doughnuts 
won the Inspiring Journey prize by 


# MakeYourideas 


Jamie explains that the 
ZeroCams “work with the 
existing camera code.” He also 
predicted that we’ ll see smaller 
camera connectors on future 
models of the Pi: “There are 
already smaller ones out there... 
it’ ll happen!” 

The ZeroCam, ZeroCam FishEye 
and ZeroCam NOIR cost £15 each 
from thepihut.com. 


explaining all the problems they 
encountered while trying to build 
a smart picnic hamper. 

Equally, Uniteam’s “great 
explanation of such a wonderful 
project” earned it the Best 
Explanation prize. Watch their 
YouTube video, Plantz with a Z 
(magpi.cc/2vfHueC). 

Don’t miss the next Pioneers 
challenge — sign up to the 
newsletter at magpi.cc/20oMNa2rc. 
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NEEDS YOUR 


VOICE 


New open-source project to make voice-based 


making easier 


oogle’s new Open Voice 

Project aims to make AIY 

Projects ‘more responsive’ 
by providing ‘a set of open-source 
voice keywords to use.’ 

But the project needs your help: 
the more people who provide a 
sample of their voice, the better 
the speech recognition gets. 

“We have around 2,000 
recordings of each word so far,” 
Google engineer Pete Warden 
tells us, “but the more diversity 
in accents we can get, the more 
people the speech detection will 
work for.” As a Brit abroad, Pete 


Google's new project should 
decrease the learning time for DIY 
voice-based builds 
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has often found himself having to 
spoof an American accent to make 
voice systems work. 

The project is only aiming 
to “enable a very basic voice 
interface”, Pete reveals, with 
single-word commands like ‘stop’ 
or ‘open’. 

Pete also confirms that the Open 
Voice Project will always be open: 
“We will be releasing the recordings 
under a Creative Commons BY 4.0 
licence,” he discloses. 

You can help the project now by 
turning on your microphone and 
heading to magpi.cc/2wmoo5I. 


The stories we shared that 
flew around the world 


magpi.cc/2tMa3if 


Can you really use a Raspberry Pi 3 as your main 
computer? After all, that quad-core 1.2GHz processor 
and 1GB of RAM should be plenty for office work. 
Follow the link to see if it’s possible! 


magpi.cc/2tEUcCT 


Julia, a next-generation coding language for data 
analysis and scientific research, is now available on 
the Pi. With the claimed ‘speed of Fortran and ease 
of Python’, Julia’s a decent choice for hobbyists, too. 


magpi.cc/2usunnP 


Microsoft has launched an online Raspberry Pi 
simulator. It's early days, but it could be a useful 
way to prototype projects without breaking out the 
breadboard - never mind the soldering iron! 
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Wells can be managed 
through a smartphone 
app as well as at HQ 


wets 


\ 
® 
9 cm , i 
aS M4 > , ee | 
ae Exe Oe 
£ - a SS : 
ss ofS? ogt e 
Sa $ ote A Or BR 
, y ts ¥ - 
i a i,- tr al 
oR or oe . 
= ps! ¥ 


a 
= Sew r 
Pa x 

-m 

| ; 


i. 
PETROLOG 


(PETROL Ts 
POC-OF } 


BETTER OIL DRILLING 
WITH A RASPBERRY P 


Pi-based smart controller increases revenue by $7,000 


ae 


exas-—based Petrolog The need for a smart meter people going to the well every day. 

Automation arises at so-called ‘marginal Also, our controller is smart, so it 

(petrologautomation.com) wells’ (also, we are told, referred finds the best times to be pumping 
has created a smart oil well to as ‘stripper wells’). As Carlos and thus increases production.” 
monitor that increases the revenue __Labrado, software developer Carlos tells us that Petrolog 
from each well by a reported at Petrolog, clarifies: “these chose the Raspberry Pi for version 
$7,000 (roughly £5,300). The wells are low-production one due to its size, low cost, and 
Smart monitor is based around a wells that are often thought features. “Now we keep using 
Raspberry Pi and a custom-made of as not worthy of a POC it because of the great support 
cellular modem. [Pump Off Condition] controller.” community... like resinOS.” 


Our controller is smart, so it finds Resin.io 


The Pirembed@edrintie Peiirele. 

POC controller runs resinOS 

the be St tume S tO be PUMPING and (resinos.io), a dedicated Internet 
: of Things (IoT) operating system 
thus INC re as eC S PIO duction from resin.io. Alison Davis, 
director of product marketing 
As the fluid level in these and strategy, explains, “Because 

marginal wells fluctuates, an resin.io uses Docker containers 
engineer must visit each wellevery to deploy updates, the Petrolog 
day to ascertain the fluid level and team can change the application 


set the pump accordingly. Some running on their oil well monitors 

of these wells are over four hours’ as often as they like, without fear 

drive away. of bricking devices.” 

Carlos explains the benefit of “Anybody can get started with 

Petrolog’s POC controller: “[It] resin.io,” Alison tells us, “whether 

saves money by not having the you’re a hobbyist with a few devices 

well turned on when there is not at home, or a professional witha 
enough fluid, and not having fleet of thousands.” She confirms 


Left Spot the Pi embedded in Petrolog's that the free resin. io Sea 
custom-made cellular modem and casing | accommodates up to five devices. 
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USING APIASAPLUG-IN PROCESSOR fe (277 


USING A PIAS A 


ea 
af 
Running the software on the Pi 
means you can control it from 


any networked device 
Big data in little Pi 


cott Edenbaum, a recent graduate 
from the NYC Data Science Academy 
(nycdatascience.com), has turned a humble 
Pi Zero into a data crunching, code trialling, data 
science-ing auxiliary processor. 

Wanting to avoid “the potential for security 
exploits” of installing MySQL on his main 


Crunching 
big data sets 
development computer, Scott instead used doesn't need 


to involve 


virtualisation software Docker (docker.com) to big hardware 


create standard environments for Python and R 

(a programming language suited to data science). 
Scott’s approach avoids the “multiple (possibly 

conflicting) dependencies” of Python and R, while 

allowing him to create his sandbox coding and ni 

testing environment quickly and easily. Building the 

environment from scratch each time is “a process 


that takes 2+ hours on a Raspberry Pi 3”, let alone N DB US T R 
a modest Pi Zero. 


Plug-in processor 


® 
“Because the device is so inexpensive, I can see there G O [ G O 


being a lot of possibility using it for education” Scott 20+ new projects for your Pj robot car. 


tells us, while the standardised environment saves 
“headaches” such as installing libraries and managing 
package repositories. 

Scott’s project could replace Excel “for some tasks”, 
while Docker “allows deployment and management 
of a few devices or hundred, without too much extra 
work.” He says there are “a lot of interesting cases I 
haven’t thought of.” 


The project is on GitHub at magpi.cc/2uh3guV, 
and Scott has documented the installation process B ri C Pi [ 3 


at magpi.cc/2fmMPd). LEGO MINDSTORMS + RASPBERRY P| 
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pi-topOS 


The OCR* endorsed pi-topOS 
(Operating system) platform comes 
pre-installed on the 8GB SD card 
shipped with every unit. pi-topOS 
software suite lets you - browse the 
web, - check emails, - create and 
edit Microsoft Office compatible 
files. It includes pi-topCODER and 
comes with the revolutionary 
educational game CEEDuniverse. 
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LEDs ere delicate Little things If you put too 
mrwch current through them they will cop 
serneters Quite spectacularly) To lent the 
current going through the LED, you should 
alweye ute & meetin @ conee wah & 

Ity conmectesy the long leg of en LED to the 
P¥s 3V3 ond the short leg to a GND pin. The 
ressstor can be anything over about 500 


- 
& 
BT 
More power to you 


Learn. Play. Create 


Quick Launch Notes 


i-topCODER 
oe -” 


pi-topCODER Is the interface that 
allows you to access worksheets 
and pre-built Raspberry Pi projects. 
It's the easiest way to tinker or 
deliver lessons by providing 
step-by-step guides for computer 
science and STEAM worksheets. 


Findel. 


for schools 
for classrooms 
for ialists 
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WWW.PI-TOP.COM 


pi-topCEED 


The modular all-in-one 
Raspberry Pi powered desktop 


K Adjustable 
Viewing Angles 


14° 


HD Screen 
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pi-top 


The modular build-it-yourself 
Raspberry Pi powered Laptop 


QD 10 Hour 
Battery Life 


13.3" 
HD Screen 


sag = Modular 
—_ Components 


Lb 
|= to Worldwide shipping available in green or grey at www.pi-top.com or our distributors 
Stay up to date with our latest news by following our social media 


The Pi Zero W isa 
fantastic piece of kit, 
and these pages are 
packed with ideas 

to inspire your Pi 
Zero creativity 
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dding wireless internet connectivity 

to the original Raspberry Pi Zero was 

at the top of many people’s wish lists 
when it was first launched. A real computer, 
amazingly small, with a built-in internet 
connection — this opens up so many possibilities 
for amazing projects. 

Since its release in February 2017, the Pi Zero W 

has been used in many amazing builds around the 


world, so we thought it was about time to highlight 
some of the exciting things you can do with the 
newest member of the Raspberry Pi family, and the 
original Pi Zero as well. Let’s get making! 
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Connect to an HDMI display 
to create your own media PC 
or interactive project 


uguWuUoo 
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This features the same CPU as in 
the original Raspberry Pi, although 
it's clocked a little higher 


Connect to a wireless network 
or Bluetooth with the radio chip 
on the Pi Zero W 
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The Raspberry Pi Camera 
Module can be added for 
photography projects — all you 
need is an adapter cable 
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GETTING 


Quick tutorials for your Pi Zero 


hile you can do a lot of things with the Pi 

Zero, it’s worth sharing a few tips to help 

you use it in even more projects. These 
can be as simple as software tweaks to improve 
performance and reduce power requirements, or 
adding hardware to make it easier to integrate into 
your projects. Here are some of our favourites. 


GPIO HEADER 


Add GPIO pins to your Raspberry Pi Zero 


YOU'LL NEED 


GET READY TO SOLDER SOLDER THE PINS HAMMER HEADERS 


Put the short legs of the 40-pin Let your soldering iron heat up Pimoroni has an excellent 
header through the GPIO holes and then solder the individual solution to adding a GPIO header 
on the Pi Zero. We like to turn it pins. Make sure no solder crosses to the Pi Zero: a special header 
upside down so the side of the Pi between the pins or you may short that can be hammered into the 
Zero with the header is raised off them out. Be careful — soldering holes with a special kit. You can 
the floor, giving a perfect view of irons are extremely hot, so let the find out more on Pimoroni's site: 
the pins to solder to the board. solder cool before touching it! magpi.cc/2lohN2U 


THE USB PORT 


quickly and easily A lot of micro USB to USB A converters can be bulky, 


Connect USB accessories 


using wires and full-sized female USBIA ports. A great 
alternative is to use a micro USB shim, which is only 
as big as the connector. This allows you to convert the 
data port while losing minimal space. 


@R) You can buy HATs and other add-ons to add 
USB ports to the Pi Zero without making the Pi 
Zero wider or longer, but these options will more than 
double its height. If you’re feeling extremely brave, you 
could try removing the micro USB and soldering on a 
. ~~ standard USB A connector, but we don’t recommend it 
se ecccccecccccccccccccccceccccccccccccesccsccccccscscccccccccbescccccseMlseeee... Unless you really know what you’re doing. 
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Look to the top right-hand corner Slot the jumper wires onto the 
of the Pi Zero and you'll see two headers, and put the other 


holes labelled TV, below the GPIO ends inside the screw terminals 
holes and next to two pins labelled of the RCA plug. The Pi Zero 
RUN. Put the short ends of the should automatically switch 
header through the TV holes, flip to this output when you plug it 
the Pi over, and solder them on. into a TV. 


Two-pin header 
2x female-to-male jumper wires 
Screw terminal with RCA connector 


COOCCCO0O 
[oKekekek omekenene 


If the video looks wrong, 


switch the jumper cables 
over on the Pi Zero 


CONNECT TO WIRELESS 
ON THE COMMAND LINE 


You'll need to know the SSID and the password 
of the wireless network. You can run a scan of 
available wireless networks using sudo iwlist 
wlan@ scan 


Open the wpa-supplicant file with: 


Go to the bottom of the file and enter: 
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few years ago, when the Raspberry Pi was 

fairly new, Adafruit produced an excellent 

guide to creating something called the Onion 
Pi. The concept was to take a Raspberry Pi, connect it 
to the internet, and then connect to the Raspberry Pi 
via WiFi. Once connected, you could then access the 
internet, encrypted via the Tor network. You can read 
the original instructions here: magpi.cc/2vCkTqq. 

We’re going to do something a little more 

straightforward, and remove the Tor functionality. So 
this will be a simple, tiny, wireless access point. 


Latest version of Raspbian 
USB Ethernet adapter 

An extra wireless dongle 
(advanced) 


We need a lot of software to get the wireless access 


point working. First, update your Raspberry Pi with: 


Then install: 


You'll need to turn off some of the new services 
you've just installed using: 


September 2017 


This works best with an Ethernet connection, but 
you should be able to use a wireless connection 
- with some caveats. We need to bridge the 

connection between the internet (eth@) and the 


wireless network (wlan@). 


Edit the DHCP file by first using sudo nano /etc/ 
dhcpcd.conf and add denyinterfaces wland@ 
and denyinterfaces eth@ to the bottom of the file. 
Save and exit, and then create a bridge with: 


Connect the network ports with: 


Open the network interfaces file with sudo nano 
/etc/network/interfaces, then change the 


wlan info to manual. 


With that done, add the information for the bridge 


to the file. 
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Now, we need to edit the hostapd file to allow 
another computer to connect to the Raspberry Pi. 
Open the file with sudo nano /etc/hostapd/ 
hostapd.conf and add the following, putting in 
your own network name and password: 


Save the conf file and open another file with sudo 
nano /etc/default/hostapd. In this file we can 
tell the system where to find the configuration file 
we edited. Find the line #DAEMON_CONF and replace 
it with: 


Save, exit, and then reboot the Raspberry Pi. 
You should now be able to connect to it from 
another device. 
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e’ve seen some great 

projects that use 

Python doesn't come with a built-in Bluetooth Bluetooth tags and larger PyBluez - magpi.cc/1VOuGCy 
module, so we need to install pybluez to our Raspberry Pis. With the Pi Zero W, Bluetooth tag or another 
Raspberry Pi.Doastandard sudo apt-get you can create a smaller tag that Bluetooth device 

update and sudo apt-get upgrade before you slips easily into your pocket. 

start. Once that's done, install the following: There are many applications that 

support this, but here’s how to get 

your tag set up. 


This is pip, the Python module installer. It works like 
apt-get, but has a different repository of software. 
We can then install pybluez using: 


You can use specific Bluetooth tags that send 
out a signal and MAC address, or you can set an 
existing device like a PC or phone to transmit its 
Bluetooth signal, which the Pi can detect. If you're 
using a tag, you could carry it with you and leave 
your Pi Zero at home. 

A tag will usually tell you what its MAC address 

is, but Windows, Android, and iOS all use slightly 
different methods for other devices. Use Google to 
look up how to find the Bluetooth MAC address for 
your device. 


Now you know your MAC address, you can plug 
it into the tag code listed on this page. The code 


is Simple — it scans the surroundings once every 


20 seconds and looks for the specific Bluetooth ; : 
MAC address. If it finds the correct address, it lets With the Pl ZCTO W you Call 


you activate the next stage, whatever you want that 


to be. With that in place, you can start using this Cre ate ad smaller tag that slips 
setup to automate your projects! : 
easily into your pocket 
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HOW TO USE 


Creative projects for 
your Bluetooth tags 


I} 
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Microphone 
Speaker 


The Raspberry Pi Zero is great 
for cosplay, as you can do 
some pretty complex things 
with it while secreting it away 
in a hidden nook of your outfit. 
Voice amplifiers or distorters 
are something many cosplayers 
will consider at some point, 
depending on their costumes. 
We like the simplicity of 


this version, using a clip-on 


microphone. The sound is input 
to and modified by the Pi, before 
being sent to the attached 
speaker. This version is used for 

a Star Wars Mandalorian bounty 
hunter costume, which is really 
cool, but the project could be 
adapted for other cosplay as well. 


September 2017 
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Button 
Video files 


Popularly known as the Simpsons 
Shuffler or Simpsons Button, 

this very simple Pi Zero project 
features a selection of Simpsons 
episodes. When you press a 
button, the Pi Zero plays a random 
episode. Obviously, you could 

do this with any media (even 
music), and all it requires you to 
do is solder a button to a GPIO pin 


and load a Python script. For the 


USB power supply 


This is a simple but excellent 
idea: attaching a Raspberry Pi 
Zero to a USB power adapter 

so that the form-factor of the 
computer is the same size asa 
plug. This can then be used to 
run a mini server, orevenasa 
travel computer. This version of 
the project by NODE on YouTube 
also includes a USB hub, so you 


can easily connect storage and 


other peripherals to the Pi Zero. 

The video includes a guide on 
how to build the power supply. 
Be careful - you're dealing with 
mains power! Don't take any 
risks with this project. 
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full Simpsons experience, there's 
a 3D-printed case design you can 
download as well. 

If you are choosing Simpsons 
episodes, we suggest limiting 
yourself to seasons three to eight. 
You'll thank us later. 


SHi/iyu rm 


Adafruit Free Digital Library 


rovide an imtermet connection, You can download any book provided and save to your device for viewing later 


Storage space 
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Disney and Lucasfilm might want 


PI-POUWEREU 


to push BB-8 as the new coolest 

sidekick, but we all know that = R2-D2 toy 

R2-D2 is the best droid in the Motor controller 
Star Wars universe, Making your -- Motor and wheels 
own remote-controlled R2 is an . 

extremely popular maker hobby, 

so much so that the version of R2 


that appears in the new Star Wars 
films is one of these hobby-builds 
(magpi.cc/2wAFbAM). 

This version is a little more 


nd Coy rt 2ES¢ 
ae. rs 2 B 
wh Y Ss straightforward, and instead of 
ae creating a one-to-one replica 
of the astromech, it’s a mod of 
a small toy. This makes it much 
easier to hack using a Pi Zero and 
some small motors. 
It might be a bit tricky to track 
down that particular R2-D2 toy 
these days, though... 


Old monitor or TV 
Two-way mirror 
Wooden frame 


Prototype board 
0.96-inch screen 
Laser-cut case 


We'll be honest here: this 

project is more about what 

you can do with the available 

technology than about making 

a neat, portable arcade 

cabinet. It's so small that it's 

not particularly comfortable the oldest of arcade games. The 

to use, but that doesn't mean buttons are soldered to some 

it's not an incredible feat of custom-made prototype boards, 

Raspberry Pi engineering. and the case is a custom design 
The back of the cabinet is the in laser-cut acrylic. Adafruit 

same size as the Raspberry Pi themselves say the design 

Zero, while the front is a little process was more of a challenge 

deeper than the board. It uses a than anything else but hey, it 

tiny 0.96-inch OLED screen, with would be a cool project to break 

a resolution of 96x64, perfect for out at a party. 
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DAC 
Amp 


JAsr CAM 


Wooden case 


ZeroVview 


The ZeroView is a cool and 

cheap add-on for the Raspberry With very little in the way 

Pi Zero that allows you to of additional coding and 
connect the Pi Zero, via suction accessories, you can easily turn 
cups, to a window. It includes a it into a dash cam for your car, 
special mount for the Raspberry keeping an eye on the road 

Pi Camera Module that means it ahead just in case. It could even 
can film through the window at be used on track days to film 
the same time. your amazing lap-times! 


‘ 
! USB retro controller 

Projects like this are surprisingly a 
easy, and we've covered a couple | ‘i 
like them in the magazine before: 
from quick, simple hacks of 
NES controllers, to installing a 
rechargeable battery system into 
a fully enclosed SNES emulator. 

All you need to do is finda 
way to connect the controller's 
USB cable to the Pi Zero. You 
can swap the USB connector 
for a micro USB connector; you 
can solder each individual USB 
wire to the Pi Zero's USB port if 
you're feeling brave; or solder 
them to the GPIO and make 
some modifications to the code. 
RetroPie lets you very quickly and 
easily configure your Pi Zero to 
play old games, and from there 


it's up to you how you use it. 
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_ SUBSCRIBE TODAY AND RECEIVE A 
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Subscribe in print for 12 
months today and receive: 


A free Pi Zero W (the latest model) 


Free Pi Zero W case with three covers 


Free Camera Module connector 
Free USB and HDMI converter cables 
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Other benefits: 
Save up to 25% on the price 
Free delivery to your door 


Exclusive Pi offers and discounts 


Get every issue first (before stores) 
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>» Aset of three 
intercoms 
originally cost 
£99.95 in 1986 


» Martin bought 
his set fora 
bargain £4 


INTERCOM 


> He put the Pi 


Benin ie Eager to evoke a sense of nostalgia, retro nut Martin Mander decided 


case's grille 


eee tO place his Google AIY kit inside an old FM wireless intercom 


coated with 
matt-finish 
craft paint 


hen Martin Mander saw 
The MagPi was giving away 
> He'd like to : 
include a a free hardware voice kit 
manual rotary from Google in issue 57, he did the The speaker from 
volume control sensible thing and rushed off to the kit was too big, 
buy a copy. But after he assembled Palicoment ell 3 
the components, placed them 
in the cardboard housing, and 
pressed the button to activate the 
Google Assistant to ask a question, 
he started to think about the 
future possibilities. 

Ironic, then, that he promptly 
delved into the past. “The family 
and I enjoy the local car-boot sales 
and I’m always looking for old, 
obsolete or broken technology 
that I can use in projects,” he says, 
relishing the chance of picking 


up something from the 1970s | 7 | 
and 1980s. i » | : Knowing his children would give 
; \. - the unit a pounding, Martin used 

He mOniced Om eae which at, / ns a screw and hot glue to ensure 
were in their battered original mS aa mp OS mi a | the microswitch stayed in place 


packaging, and he thought it’d be 


fun for the kids to be able to chat 4 = 
between their rooms. “They didn’t eo Conn ee a OT etich, 
work, and so! shelved them in i < : thankfully, were also long 
the workshop,” Martin continues. 0 803 enough for uemcose 
“Then the Voice HAT came along a ro) 

and I decided it would be nice ia 

to preserve the spirit of these 3 

intercoms in a small way.” 4 »J0| emer D5 ® 


Martin’s idea was to fit the Google 
AIY kit into one of these old units. 
“Td followed the instructions in The 
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Activity 


New Applet 


if thisthen that 


Want to do more? Build and publah Applets that work with any of 
the vervices om IETTT 


Aeon = Puthoem «= Blog «= Commvenity «= fobs «Terma = Privacy 


>STEP-01 
Using IFTTT 


Martin wanted to expand the Google Pi 
Intercom’s abilities, so he logged into ifttt.com, 
clicked My Applets, selected New Applet, and 
then clicked the ‘’ icon on the next screen. 


MagPi to assemble the HAT and get 
the software up and running on the 
Pi,” he recalls. With the Pi and HAT 
running on his desk, he tested some 
voice commands before getting 

on with the task of cracking open 
the old intercom. “There’s always 

a Slight feeling of naughtiness in 
ignoring the ‘do not open’ warning 


>STEP-02 


Finding Google Assistant 

Having searched for Google Assistant and 
clicked Connect, he signed into his Google 
account. He could then select a trigger 
and fill in the phrases that would activate it. 


| | Complete trigger fields 


Send a text 
message to 


someone with 
your Android 
and Google 


urmon 


te ee 


>STEP-03 


Organising the response 


——<—— S ———————s 


? i, /ST7¢ 


and seeing what’s inside,” he says. @@= 


“The great thing about older tech is 
things tend to be screwed or bolted 
together, allowing them to come 
apart nicely, leaving just the case.” 
Having made lots of tiny 
measurements, he was convinced 
the kit would fit, so he cleaned and 


| 


4 : — 
5 f ; ay 
aa ¥ . a Ug a 
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Theres always a Slight feeling 
of naughtiness 1n ignoring the 
do not open’ warning 


spray-painted the front of the case, 
let it dry, and began bolting the 
Pi into the case, adding the other 
components around it. “I set aside 
the green push-button from the kit, 
but kept the microswitch and fixed 
it inside the case alongside the big 
hinged intercom button.” 

Getting the microswitch in exactly 
the right place was the greatest 
challenge and it involved lots of 
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trial and error: “Because it was 
being activated at an angle by the 
rear of the button, even a couple 
of millimetres made the difference 
between the microswitch sticking 
‘on’ or there being too much play 
in the action.” 

Martin then removed the LED 
from its case and soldered in a two- 
hole component connector to secure 
it between the Pi’s USB ports, under 


the original microphone grille. 
“The kit’s microphone board was 
just glued into place once I’d drilled 
holes in the top of the case. Once 
that was in place, I connected the 
cables and closed the case.” 

Martin is pleased with the result: 
“The kids have described it as 
fancy and futuristic, which [ll 
happily take.” He has since linked 
the intercom to his IFTTT account 
(see ‘A connected home’ box). 
“This took some configuring,” 
he concludes, “but thinking up 
responses for the intercom to read 
out when the triggers are activated 
was really good fun.” 


His idea was to get the intercom to 
send a text to his wife when he says 
he's home. He chose SMS as the action 
service and filled in his mobile number. 


ft The project 
used a repainted 
and cleaned 
intercom bought 
from a Car- 
boot sale 
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MATT, BOMANI & EUNICE 


Matt Zheng, Bomani McClendon and 
Eunice Lee are students of design and 
computer science at Northwestern 
University in Illinois. 
magpi.cc/2vANCvc 


Image: Eunice Lee 


WAT'S YOUR MOTTO? 


WAVES 


Turn the sound of your voice into a printed waveform  4veve Two printouts of different responses, 


both answering the question on the left 


- = 
» Cr a 


a 
« 
> 


’m grateful for finishing 
this project,” says maker 
Eunice Lee as she holds a 
button while speaking into a large 
silver microphone. A printout of 
The project the sound waves produced by her 
took 7-8 hours voice emerges from the device’s 
to make 

thermal printer. 
A controller This is a demonstration of 
script handles WwW ‘al ai 
subprocesses aves, a Side project created by 

Matt Zhang with Eunice Lee and 
There's no 
-AaMPALIN Bomani McClendon, students 
recording of design and computer science 
length at Northwestern University 
The same in Illinois. 
aTOUAE OE “During our first meeting, we 
paper is used ; ne 

shared some inspiring hardware 


4 « a 


each time 
rojects we’d seen, and hada 

Build details P a 
and eade are brainstorm session where we drew 
on GitHub out lots of wild, funny, and weird 
magpi.cc/ project ideas on Post-it motes, ” What's your motto? Make a wisnh' 
2vANCvc ae 

recalls Bomani. “Afterwards, fc) & 


we voted on the ideas and filtered a) ; I 

Below Matt Zheng one 
looks pleased withthe them by feasibility, materials 
Oe Pie oe le cos rane (mose importa) 


answer - we wonder What are Gi 
ou grateful ive us your 
what he's gratefulfor! excitement. We chose Waves, ae aa best ae 
ae —— —— — 


Image: Matt Zheng 


weet are You oratefu! for + | 


OE EE———————————<- 


Users choose The thermal 
to answer one printer plots a 


Holding the relevant 
colour-coded button, 
of four open- waveform of the 
ended questions recorded response 


the user records 
their answer 


Image: Eunice Lee 
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and later learned that Raspberry Pi 
would work well for the project.” 
Meeting for weekly sessions, 
it took the trio two to three 
months to create the finished 
project. “We encountered a fair 
number of problems during every 
work session, but we managed 
to overcome them by the end,” 
reveals Matt. 
“Having a couple of ground 
rules set from the beginning really 
helped,” reckons Eunice. “For 
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of the sound waves would mean 
more to the participant.” 

A Python script converts the 
recording of the user’s answer into 
a graphical waveform to print. 
“The programming wasn’t too 
tricky, since we borrowed a lot 
from open-source Python code,” 
says Matt. “The plots take up the 
Same amount of paper, no matter 
how long the recording is, but 
we have to manually adjust the 
volume on the microphone, to 


We all brought different skills to 
the table, but a mutual excitement 
for Waves and what it could be 


instance, we decided to always meet 
once a week and to commit toa 
project that would take less than ten 
hours to build. This kept the project 
lightweight, fun and stress-free.” 

“For me, the best part of this 
project was getting to work with 
Eunice and Matt,” says Bomani. 
“We had a lot of laughs during 
our sessions.” 

“We all brought different skills to 
the table, but a mutual excitement 
for Waves and what it could be,” 
adds Eunice. 

After brainstorming ideas for 
open-ended questions for users 
of Waves to answer, the team 
narrowed them down to the final 
four. “We wanted the questions to 
be personal and reflective,” explains 
Eunice. “That way, receiving a print 
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make sure that the audio doesn’t 
blow out or disappear entirely.” 
The result can also be uploaded 
to a locally hosted website, which 
was displayed on a monitor during 
an annual Design Expo at the 
university. “The idea for the website 
was that people could see other 
people’s sound waves and wonder 
what was said,” says Eunice. “It was 
a really fun addition that turned 
some heads and made people 
interested in what our project was.” 
Eunice was delighted with the 
overall reaction to Waves: “It 
was really great to see people’s 
faces light up when they finished 
recording and saw their sound waves 
being printed. [...] The best part was 
being able to give that to the user 
and say, ‘You can keep it!’.” 


WAVES 


PRINT OUT 


Projects 


YOUR VOICE 


>STEP-01 


>STEP-02 


>STEP-03 
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Projects 


> Daniel 
estimates a 
Pi Deck setup 
costs $182 


>» There is no 
soldering or 
modification to 
the turntable 


» Audio Injector 
sound cards 
cost around £20 


>» A Serato CVo2 
control vinyl 
pressing is 
recommended 


> The FLAC 
music format 
gives the 
best results 


DECK 


Digital music can’t be scratched - or can it? Daniel James and 
Chris Obbard go ‘old school’ with a Pi-based digital vinyl system 


ver since he saw 

Breakdance: The Movie in 

1984, Daniel James wanted 
to be a DJ. But he soon realised 
scratching expensive vinyl or 
carting it from venue to venue is 
far from ideal. “Unless you are 
famous enough to have a roadie, 
large boxes of vinyl are heavy and 
impractical,” he tells us. There’s 
also the problem that a lot of music 


This specially tweaked version 
of xwax lets you load tunes 
and see their waveforms 


een 


The music files are on a portable 
USB stick connected to the Pi 


As you interact directly with 
the record, the Pi senses 
the needle's position 
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is not being released on analogue 
vinyl, despite the huge resurgence 
of interest in the format. 

Digital Vinyl Systems (DVS) 
have long provided an alternative. 
They allow you to DJ using digital 
music files and software while 
letting you benefit from the feel 
of a turntable. You simply place a 
special vinyl record on a standard 
turntable and the system will read 


the position of the stylus from a 
timecode. This is used to play backa 
digital music file at the same point 
in time — but these systems can be 
hugely expensive. 

Not now. Daniel and his colleague 
Chris Obbard at 64 Studio put a 
Raspberry Pi 3 alongside a standard 
vinyl deck, eliminating the hassle 
and expense of hooking digital 
decks to a laptop. They figured that 
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The Audio Injector stereo sound card adds line-level audio inputs to the Pi 


all you need is a USB stick packed 
with music files. “As long as there 
is low latency in both directions of 
travel, you can make effects such 
as rubbing the kick drum beats, 
scratching and backspins sound, 
feel and look realistic,” Daniel says. 
Motivated by a desire to show 
that low latency applications 
could work reliably on small and 
inexpensive ARM devices such 


" Most of the setup 1s done with 
Shell script, which 1s easy to hack 


as the Pi, Daniel and Chris got to 
work. They used xwax (xwax.org), 
an open-source DVS for Linux 
capable of playing MP3, FLAC, and 
AAC files, among others. “But 
because xwax isn’t easy for people 
new to GNU/Linux to set up the 
system optimally, we created a 
ready-made Debian image for the 
Raspberry Pi that is specialised 
for this one application,” reveals 
Daniel. “It means DJs don’t have 
to go through as many steps to 
get it running.” 

The pair had tested Raspbian 
images and various kernels with 
hand-soldered audio hardware to 
create the inputs and outputs that 
they needed. “Then we tried a HAT 
sound card from audioinjector.net 
and some USB audio interfaces 
which include phono cartridge 
preamplifiers. These are needed 
because the stylus on the record 
outputs a signal at a very low level, 
compared to other audio devices.” 
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The greatest challenge was 
eetting the audio interfaces to 
work with low latency since many 
of the known techniques are 

for PC architecture. “Interrupt 
tweaking doesn’t work the same 
way on the ARM architecture, for 
instance,” Daniel explains, “but 
switching to newer Linux Kernels 
helped a lot.” The majority of 

the work involved configuring 


oe 
and scripting various programs 

to work smoothly together with >STEP-02 
minimal user input. “Most of the TIOr 7 
setup is done with shell script, 
which is easy to hack.” 

A screen completed the package. 
Daniel and Chris decided to use 
the official Raspberry Pi seven- 
inch touchscreen. “We wanted 
something that would be easy to 
set up,” Daniel continues, “but the 
Pi Deck works with any compatible 
screen. If you’re not using a 
touchscreen, an ordinary mouse 
can be used to click the buttons. 

A QWERTY keyboard is useful for 
searching music titles.” 

Since creating the Pi Deck last 
October, the pair have been excited 
at the level of positive feedback. 
Hearing about people using it 
across the world has been music to 
their ears. “People appreciate the 
low latency and stability,” Daniel 
concludes. “These are the crucial 
factors for any performance.” 
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» Alonso learnt 
the majority 
of his maker 
skills from 
internet videos 


>» Mira went 
through 
multiple designs 
before her final 
egg shape 


» She charges via 
a small port on 
her base 


> Mira’s small on- 
board camera 
can utilise face 
recognition 


» Alonso's next 
build, Lumens, 
doubles as a 
night light 


Alonso Martinez explores the ideas of interaction and individuality in 
robots, creating adorable Raspberry Pi-based characters that play and learn 


n animator by trade, 

Alonso Martinez wanted to 

take his maker skills to the 
Meximievelmnedecidcedmtorexplone 
the idea of interactivity with robot 
characters by creating Gertie, Mira 
and Lumens. 

With Gertie, he was able to 
explore the idea of the ball bounce - 
a Staple in animation school, where 
students are asked to animate a 
ball, and the reaction of its surface 
when it connects with another 
object. Where Gertie excelled at 
bouncing, there was still a lack of 
the emotion and personality that 
Alonso hoped to achieve. 


Mira’s blinking eyes are powered 
by two small LCD screens that 
run constant animations 


Her shape is the result of 
an exploration into shape 
science, and how we 

perceive certain features 


Mira’s recent appearance on 
the YouTube Tested channel 
attracted a storm of people 
desperate to buy their own Mira 
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Mesmerising Mira 

Enter Mira. Alonso wanted to 
create a character that was not only 
aesthetically pleasing and highly 
interactive, but also able to explore 
the science behind how we perceive 
a character based on its shape and 
features. Mira’s round form is the 


result of a study into shape science. 
Her lack of limbs and sharp edges 
creates an instantly accessible and 
pleasing character. And her eyes, 
with their mini LED screens that 
blink with their deep, somewhat 
galactic blue orbs, draw us to her 
Devil Micke lene mais. 
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Mira’s control circuits sit inside her egg-shaped P 


body, with millimetres of space to spare 


But Mira is more than just a 
pretty face. Inside her body lies 
a Raspberry Pi, laden with code. 
Cover your face, for example, 
and Mira will recognise the game 
of peekaboo via her on-board 
camera, offering up a shocked 
squeal of excitement when you 
say “Boo!” and reveal yourself. 
Sit Mira beside you at a piano 
and she’1l sing back to you any 


Mira and Lumens build their own 
code and truly create their own 
unique identities? 


Millimetre-perfect 

Stepping back from the mind- 
blowing concepts of interactive, 
intelligent robots, the physical 
build behind Mira and Lumens is 
equally impressive. As an animator, 
Alonso is highly skilled in 3D design 


Her lack of limbs and sharp edges 
creates an instantly accessible 
and pleasing character 


note that you play, shaking her 
head like a bird from a classic 
Disney movie. And while all this 
interaction is fun and pleasing, 
Alonso is planning to take the 
build further. 


Robotic evolution 

Alonso wants to explore the 
idea of code evolution through 
interaction and play. While it’s 
cute to play with Mira — or her 
successor Lumens, a mushroom- 
shaped light that hides under its 
cap — what if she could do more 
with the information received? 
What if, through the unique 
individuality of the user, the 
robot created its own, similarly 
unique personality°® While 
explaining the concept, Alonso 
touches on Conway’s Game of 
Life and the concept of cellular 
automation with code. Could 
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using the computer animation 
software, Maya. And it was through 
Maya that Alonso sculpted his 
robots, enabling him to recreate 
the Raspberry Pi and components, 
and measure his 3D prints to the 
millimetre. Those blinking eyes 
that give Mira so much personality 
come from two ultra-thin screens 
that slip between the two layers of 
her body. The space was so tight 
that Alonso found himself having to 
sand down solder just to make them 
fit. And as for the way her ‘head’ 
moves over several axes° He took 
the idea of the joystick he’d used as 
a child to play games and recreated 
the function using 3D-designed and 
printed parts. 

Mira and her growing family 
are constantly evolving, and we look 
forward to seeing how Lumens takes 
shape moving forward. Hands up 
who wants their own? 


With his latest creation, Lumens, Alonso aims to 
incorporate the function of a night light into the robot, 
while maintaining the ideas behind Mira 
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Editing text documents is a vital skill to learn when using a Raspberry Pi 


Me 


PF seease noes txt 


TOHOSSE_NOS BT ~S 


“P eles se_notes xt 


release_notes txt 


2017-06-21 
* Scratch 2 application included 
Thonny Python IDE included 
* New icons with thinner outlines 
* Volume cont more linear in behaviour 
* Updated Flash player 
* Updated RealVNC server and viewer 
Various tweaks and b 
* New kernel and firmw; 
2017-04-10 
" Wolfram Mathema o 
* Adobe Flash Player da 
* Use PARTUUID to suppor 


* 


1xes 
AXGS 


2017-03-02 
* Updated ) suppor t) 


* Wolfram 


NOOBS 


ssh’ file on the NOOBS partition 


-02?-16 
Chromium browser updated to version 
Adobe Flash Player updated to version 24 
RealVNC Server and Viewer updated 
Sonic Pi 
* Node-RED 
* 


* 


* (RealVNC Connect) 
- version 2.11 
version 0.15.3 


0117 


Scratch updated to version 
a = 


Detection of SH enabled with default password moved into PAM 


ed desktop GL driver to ion 
of fixed HDMI resolutior 


f serial terminal 


jport use o 


serial hardware independent o 


. bo + 


--More--— 


lates 


Various minor bug fixes and usability and appearance tweaks 
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GNU nano 2.2.6 File: release notes.txt 


rrypi: 


errypl: 


Read 203 lines 


File ey 


6 O° & © Bhecer-n- % * Upgraded applications - Epiphany browser, Scratch and 
seen © Included app is - LibreOffice, Cla 


Mod © Included ili s - Alacarte menu 

New GUI-based berry Pi Configur 
GPIO control now possible without need 

link to Magpi magazine included 

: lugin to eject j 


GNU nano 2.2.6 File: release _notes.txt 


Default b is nc 
Look and feel now bas = 

Print screen key launches scrot to produce screenshot 

Common keyboards autodetected by GUI and drivers loaded accordingly 
Numerous small t j 

»-05-05: 


Updated UI 


Spl groups 
and spi devices 
-02-16: 
Newer firmware with various fixes 
New Sonic Pi rel 


How to extract just about any file on your Raspberry Pi 


SOc: $ FS @ | ox} 1809 


“Di extract files 


CD | GB iiscos-2017-04-13.1. 
Li — 


Archive Action + 


Location 


, Options 


3 +, les (18 GB) Overwnte exist ng Ties 
~¥ Extract files with full path 


Freshen existing files 
Update existing files 


et Extract 
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Tutorial 


> MIDI 7 USB 
interface lead 


> MIDI sound 
module 
(any type) 


A block diagram 
of the complete 
hardware setup 


Make great polyrhythmic music, generated by your Pi 


ack in The MagPi #58 we showed you our 

Hexome simulator, running on a mobile 

device and controlling a sequence. It used 
concentric rings of trigger positions, starting with a 
ring of six with each subsequent ring having six more 
trigger positions. Now we take that basic idea, run 
with it, fall over, pick up the pieces, and assemble it 
into a universal polyrhythmic sequencer. 

The basic concepts are the same, but this project 
gives us nearly unlimited flexibility. Each ring 
generates only one note, and those notes can be 
changed by mapping. However, almost everything 
else has changed. There are up to six rings in the 
sequence: each ring can have a maximum of 32 trigger 
positions, and can be individually muted. The big 
change is that each ring can have its own individual 
sound and volume, courtesy of MIDI. 


MIDI connection 

MIDI stands for Musical Interface for Digital 
Instruments. It is avery old standard, but still 
as popular as ever. MIDI is a serial interface that 


MIDI in 


MIDI out 


USB / MIDI 


MIDI Sound module 


sends messages between musical devices, which 
include instruments (like a keyboard), and sound 
modules that generate an audio signal. Some devices 
can combine the two categories in one device — the 
most popular being sound-generating keyboards. 
Messages consist of two or three bytes, and cover 
commands such as Note On and Note Off, as well as 
other controls, including volume, vibrato, echo, and 
pitch bend. 

A MIDI connection can control 16 different 
channels, where a channel can range from one voice 
or sound to a totally separate piece of hardware. 
Often instruments have a switch that determines the 
channel they transmit on, and most will default to 
channel 1. 

MIDI runs at the quirky baud rate of 31,250 baud. 
It is odd by today’s standards, but in the old days it 
was used because it was simple to generate. A MIDI 
device can have an input and an output, and, much 
to the surprise of younger people, an input must be 
connected to an output. There can also be a MIDI 
‘Thru’ (‘through’ in English), which is simply the 


Audio in 


Amplifier & Speakers 


Audio out 


MIDI in not used 


The polyphonic sequencer controls 
are displayed on the screen 


You'll need a USB to MIDI interface box to 
allow the Pi to talk to the module 


This MIDI sound generator module is a Yamaha MU10 


signal from an MIDI input, passed to an output, 
allowing one MIDI output to talk to a number of inputs 
in a chained fashion. 

The quirky baud rate is a historic accident. At the 
time, you would have used a 1 MHz clock for your 
processor, which you simply divided by two to give 
500 kHz. This was fed directly into the UART (serial 
chip), which required a clock signal of 16 times the 
baud rate, giving you 31,250 baud. While the Raspberry 
Pi can’t support that rate directly, it can be helped 
to do so. Although this was relatively simple on 
earlier models, the Pi 3 uses the good serial port for 
Bluetooth, and the second serial port is tied to the 
clock speed — which can be variable depending on 
processor demand and temperature. The simplest 
solution is to bypass the serial port and plug in a USB/ 
MIDI lead. While these used to be expensive, today 
you can find them for less than £5. 

We also chose to use a hardware MIDI sound module 
for this project. We used the Yamaha MU10, but there 
are any number of modules that could be used - many 
available second-hand at bargain prices. There are 
many other options for this project — see the ‘Taking 
it further’ section at the end of this article. The basic 
setup we used is shown in Figure 1. 


Why MIDI? 

So why use MIDI for this project? Other projects 

we have worked on involving sound generate that 
sound by playing samples. Those samples have to be 
found, recorded and put into the appropriate files. 

If you want to use more than a handful of different 
instruments, this is a lot of work. It can also result 
in an unsatisfactory quality of sound, because you 
can’t control the individual volume, and you can 
experience audio clipping if too many samples are 
played at the same time. By using MIDI, we can leave 
the instrument or voice generation to another piece 
of hardware or software. 


Polyrhythmic sequencer 

The original Hexome was based on a hexagonal grid 
of concentric circles. This gave an inner ring of six 
positions. Around that was a circle of 12, around that 


a circle of 18, and so on. This led to a rule that any ring 
Rn has the number of positions in Rn given by: 


Rn= Rn-1 + 6 
... where Rn-1 is the number of Keys in the previous ring. 

With this software, we can base the rings on any 
number, so that formula becomes: 

Rn= Rn-1 + B 
...where B is the base number of the innermost 
ring. This leads to the concept of a Triome, based on 
three positions on a ring — or a Quadome, Pentome, 
Heptome or Octome. Each of these models can be 
set up using this software. Additionally, any number 
of trigger points can be set up on aring, up toa 
maximum of 32. For example, if each ring has the 
Same number of trigger points, you have simply 
produced a conventional N step sequencer. 

The length, or number of steps before repeating, of 
any particular setup is given by the highest common 
factor of each of the rings. This is maximised in setups 
where the rings contain a prime number of trigger 
points, as this gives a sequence length of the number 
of trigger points in each ring multiplied together. 

If you start at two triggers for the smallest ring, 
this gives a staggering 30,030 steps before a repeat. 
Starting with a base of three you get even more, at 
255,255. At these sequence lengths, the result is 
indistinguishable from random sounds. 
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Figure 2 

Learn to control 
the sequencer 
and make some 
great music 


By Controls f 
Go 


Steps before repeat 


SEQUENCE_LENGTH 


Implementation 

To write the code, we are going to use the Processing 
language. If you haven’t already, install Processing by 
opening a Terminal window and typing: 


curl https://processing.org/download/ 
install-arm.sh | sudo sh 


You also need to install two libraries. From the 
Sketch menu, go to the import library entry and 
choose Add Library, then search for and install 
controlP5. This deals with the variable controls. 
Then repeat this and install the themidibus library. 
This is the library that will generate and send 
the MIDI messages. 

As the code is rather long, you can download it from 
magpi.cc/iNqJjmV. It is entirely operated from the 
keyboard or mouse attached to the Pi. 

The number of rings is limited to six in this 
implementation, simply because the resulting 
980x720 pixel window is all that will fit on a standard 
HD screen. If you want a seven-ring sequencer, you 
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Ring Channel 


Note Mapping 
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Ring Velocity 


would need a window measuring at least 1100x860 
pixels. Each ring is limited to a maximum of 32 trigger 
points, again due to the physical resolution of the 
screen. This is despite using the trick of changing the 
ring width depending on the number of trigger points. 


The Code 


The code is written in three sections, or tabs: these are 
Poly, Controls, and Note_Map. In the Poly tab, the 
line at the start: 


MidiBus.list() 
... lists all the MIDI devices that have been recognised by 
the computer, both as input and output devices. We are 
only interested in output devices, and it is likely that you 
will only have one such device plugged in. If so, the line: 


MidiBus(this, @, 1) 


...which selects the MIDI device to use, will not need 
to be changed. 
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Three different setups for this program 


The controls 

Figure 2 shows the screen, with an explanation of the 
controls and what they do. In order to fit round the 
circles, and to minimise the window width required, the 
controls are scattered around the outermost circle. Most 
of the controls need repeating for each ring, including 
the ring length and mute controls. Others apply to the 
whole instrument, including the speed control, along 
with the Stop/Start, Reset and Clear commands. 

The configuration controls give you some preset rings 
and trigger position numbers. These can be modified by 
the ring length controls, but it is a convenient place to 
start. The instrument controls determine the voices for 
each ring. On startup, this is set to 0, which is a Grand 
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Piano. For a list of which instruments correspond to 
each number, see the implementation sheet for your 
MIDI sound module. 

On the lower right-hand side of the screen is the 
MIDI channel for each ring. These can be set to the 
same channel to play all the notes with the same 
voice. Similarly, the Velocity number determines 
how hard an instrument is ‘struck’. You might like 
to think of this as a volume control, which in a way it 
is — but a good sound module will also subtly change 
the timbre of the sound as the velocity increases. 

The note mapping is controlled by the buttons 
running down the right-hand side of the window. 
This controls which notes are generated on each 
ring, as defined in the Note_Map code tab. The top 
five are arranged in thirds, ascending; whereas the 
next five are in a pentatonic scale. It is a good idea 
not to change between these in a Single piece, as the 
resulting key change can be jarring. The lower seven 
mappings are simple single-note shifts in the key 
of C major. These settings can easily be changed by 
altering the code in the Note_Map code tab. Figure 3 
shows three different setups for the program. 


MIDI channel 9 


There is something special about MIDI channel 9. 
When you use this channel, for each note number 
you don’t get a change in note pitch, but a different 
percussive instrument, including cymbals, drums, 
cowbells, blocks, and whistles. With the same 
mapping as the pitched notes, it can be pot luck as to 
which instrument ends up here. 

It is possible that as you change some parameters 
on the fly, you can be left with a hanging note. This 
is a note where the sound module has received a Note 
On message, but no corresponding Note Off message. 
If you get a hanging note and want to reset it, click 
the Reset control. This sends Note Off messages to 
all possible notes on all possible channels, a process 
which takes less than two seconds. 


DOWNLOAD: 
magpi.cc/1NqJjmV 


Check out Mike's 
Bakery videos at: 
magpi.cc/1NqJnTz 


Taking it further 

You can extend any program. Despite its flexibility, 
this one is no exception. The most useful change 

you could make is to include the ability to save and 
load the patterns and controls you have created. 

It is just a matter of saving the appropriate arrays, 
and restoring them when you load the program. You 
also might like to have a special set of mapping that 
kicks in when the percussion channel, channel 9, is 
selected. You might want to use a soft synth as your 
sound generator — this could be on another computer, 
another Pi, or on the same Pi you are using to run the 
software. The fluidsynth and qsynth combination is 
popular on the Pi, but there are several MIDI-capable 
synthesizers out there. You could even investigate 
routing the output of this sequencer into Sonic Pi. 


Note the sensor 
connections to the 
header for the GPIO 


A temperature sensor is installed 
in the cork, passing through into 
the water in the bottle 


The Raspberry Pi installed on the chiller unit using Velcro 


WINE SAVER’ 


ROOM TEMPERATURE MONITOR 


This project monitors the temperature of a wine storage room hourly, 
and sends an email when it exceeds an ‘alarm’ or ‘fail’ level 
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Pi Zero W 


4GB (or larger) 
microSD card 


Suitable case 
for the Pi 


Waterproof 
DS18B20 
temperature 
sensor 


Stacking header 


Gmail account 


Empty wine 
bottle and a cork 
that fits it 


e have a wine storage unit in our garage, and 
over the last 20 years the compressor has failed 
twice during extreme heatwaves. We weren’t 
constantly checking the temperature display, so we 
had no warning of the impending failures, which would 
have allowed us to move the wine to an air-conditioned 
location and have the compressor repaired. This project 
provides hourly logging of the temperature, and sends 
warning emails if the temperature exceeds set limits. 


Software setup 
Download and install the latest version of Raspbian 
Jessie Lite on your microSD card. Initialise Raspbian 
with sudo raspi-config to the proper international 
options (time zone, keyboard, wireless country 
code, etc.), change the default password, and set the 
host name in advanced options to something like 
‘wineroom’. Make sure that you enable both SSH and 
1-Wire in the Interface section of raspi-config. 
Reboot (otherwise your keyboard settings may not be 
correct), and set up the wireless by editing the relevant 
config file: sudo nano /etc/wpa_supplicant/wpa_ 
Ssupplicant.conf. Add these lines to the end. 
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network={ 
SSid="your ssid" 
psk="your password" 
key -mgmt=WPA-PSK 


Be sure to replace "your ssid" and "your 
password" with the actual values for your network, 
and keep the quotes. Now reboot again. 

Use the ifconfig command to see the IPv4 address 
that you will need to SSH into the Pi later. Write it 
down (192.168.1.27 or 10.0.0.27 are typical values). 
Now you should run the usual update and upgrade to 
the operating system: 


sudo apt-get update && sudo apt-get upgrade -y 
Next, install the mail and ssmtp applications: 
sudo apt-get install ssmtp heirloom-mailx 


Edit the ssmtp configuration file to point to your 
Gmail account as shown. Add the text below to the end 
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of the configuration file with sudo nano 
/etc/ssmtp/ssmtp. conf. 


# Wine Room Monitor settings - for gmail 
hostname=wineroom 
root=your-mail@gmail.com 
mailhub=smtp.gmail.com:587 
FromLineOverride=YES 

AuthUser=your gmail name (leave out the @ 
and stuff after that) 

AuthPass=your gmail password (no quotes 
needed here) 

UseSTARTTLS=YES 

UseTLS=YES 

AuthUser=LOGIN 


Now save the file and exit. As we will run the 
monitor program with crontab, we must also change 
the /etc/ssmtp/revaliases file or authentication errors 
will occur. So, sudo nano /etc/ssmtp/revaliases 
and add the following line: 


root : your-email@gmail.com: smtp. gmail.com:587 


Now reboot. 


The program 
Log back into the Pi. First, create a directory called 
wineroom and move into it: 


mkdir wineroom 
cd wineroom 


Download the ds18b20.c file from GitHub 
(magpi.cc/2uBzIR4) and customise it for your email 
address and your alarm temperature levels. To compile: 


gcc ds18b20.c -o ds18b20 -Wall -std=gnu99 


Hardware setup 

Take the wine bottle cork and cut it to half its length 
with a hacksaw. Carefully clamp it and use a 1/4" bit 

to drill a hole lengthwise through the centre of the 
cork. Next, push the DS18B20 sensor's stainless steel 
through the cork so that it is protruding from the other 
end — this is why we cut it in half. Wetting the sensor 
may make insertion easier. Now rinse the wine bottle 
with hot water and fill it nearly full of water. Wet the 
cork and push it carefully into the bottle, then put the 
bottle on its side to check for leaks. You may need to 
add a bit of silicone to seal around the sensor. 

On the stacking header, solder a 4.7 kQ. resistor to 
Pin 1 and Pin 4. Solder the sensor red wire to Pin 1. 
Solder the white wire to Pin 4; the black wire to Pin 5. 

Now plug the header onto the Raspberry Pi (make 
sure it’s off!), being careful to get the location of Pin 1 
correct. Boot the Pi up, log in, and test it with: 


raspberrypi.org/magpi 


Place the wine bottle sensor below the top of the rack 


DOWNLOAD: 
magpi.cc/2uBzlR4 


cd wineroom 
sudo ./dsi8b20 & 


Look at the file in your /home/pi/wineroom directory 
called wine.log. There should be one entry. You are way 
over the temperature range and should get an email 
showing an alarm or alert. This will test whether you’ve 
eot the email settings correct. If you don’t get an email 
in a few minutes, take a look at /etc/ssmtp/ssmtp.conf 
again to see whether there are any errors. 

Now we create a short script to rename the log file and 
add the year and month to the log file name at the end 
of every month. Of course, since we run it on the first 
of the month, we need last month’s date. Download 
logupdate.sh from GitHub, edit it to incorporate your 
email address, then make it executable: 


chmod +x logupdate.sh 


Next, we automate things with crontab by editing 
with sudo crontab -e and adding two lines to the 
end of the file. The first line runs the code at five 
minutes after the hour, every hour of every day, and 
the log file renaming happens at four minutes after 
midnight on the first of the month. 


5 * * * * /home/pi/wineroom/ds18b20 
401 * * /home/pi/wineroom/logupdate.sh 


Save the file, then to get the new crontab 
entries working: 


sudo service cron start 
sudo update-rc.d cron defaults 


Use some Velcro on the bottom of the Raspberry 
Pi Zero W case to attach it to the cooler unit. If there 
is no power plug inside the wine cooler, remove a 
bit of the sealant around the cooler and run a micro 
USB power cable through. Then replace the sealant to 
close the system back up, power it up, and let it run! 


CREATE A 
UNIQUE GMAIL 


Create a 
brand new 
Gmail account 
just for this 
purpose. A 
unique Gmail 
account for 
the wine room 
prevents a lot 
of spam. 


USE BITVISE 


Use Bitvise 
instead of 


PuTTY (same 
developers) to 
check on the 


temperature at 
any time. 
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HENRY BUDDEN 


Following the release of the Raspberry 
Pi when he was 12, Henry taught 
himself to code and use/break 
electronics, and has shared this 
process with the world on his website. 
magpi.cc/2eCbaMf 
twitter.com/pi_tutor 


Full touch control of 
the 3D printer and 
live view of status 


A £150 Prusa i3 
printer from eBay 
| 


WwW oe 
| oe a. 


WITH YOUR RASPBERRY PI 


Climb on board the 3D printing bandwagon on a budget, using a cheap 
but powerful printer controller with a Raspberry Pi at its core 


he rise of 3D printers has seen numerous reliability and quality a considerable factor in these 
> 3D printer inexpensive models becoming available in price differences. In an attempt to keep the cost of 
with updated the £100-£150 bracket, but what is the best this project low, we opted for a £150 Prusa i3 clone 
pelea way to interface with them? A Raspberry Pi, of course! new from eBay. The printer came as a kit and required 
. This tutorial will cover the things you need in order a few adjustments, along with some Googling due to 
. pare mucroet to control your already working 3D printer with a Pi, difficult-to-translate instructions. 
allowing you to have remote access and monitoring Even so, this should be easy enough for a complete 
"usa Wir dorala capabilities for your printer from anywhere in the 3D printing novice. 
if needed) world; as well as the ability to start printing, cancel, There are many of these clones available at a 
> Official and tweak the settings mid-print, thanks to our similar price online. If you would prefer a branded 
touchscreen favourite little credit-card-sized computer. budget printer, you can buy a Startt printer for £99 
> Repetier Pro ; ; from imakr.com. However, it still requires building 
subscription Choosing your printer and adjusting, and has a smaller build volume than 
(optional) If you are not already lucky enough to be the proud the Prusa. For larger amounts of money, the official 
> USB webcam owner of a 3D printer, then the first step is to choose Prusa 3D printers can be purchased, as well as many 
(optional) one to buy. There are many options on the market, others. As this market has grown so rapidly, there are 
ranging from £100 to upwards of £1,000, with countless options. When buying a 3D printer for use 
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3D PRINTING WITH YOUR RASPBERRY PI 


with a Raspberry Pi, ensure that the printer has a USB 
interface and that the firmware is recent. 


Setting up the software 

Once you have built your printer by following the 
specific instructions, you should be able to print 
normally, if directly connected to a computer. You’|1 
soon realise that this is a solution with very limited 
functionality, as you have to be directly connected to 
the printer in order to make any changes to it. 

To set up the software on your Raspberry Pi, head 
to magpi.cc/2vBupZw and download the OS image 
specified for the Raspberry Pi. Once you have done 
this, unzip the file and write the image to your 
microSD card. 

If you are using an official touchscreen, connect 
this to your Pi, as well as a method to connect toa 
WiFi network if needed. Once the Raspberry Pi is 
powered on, the touchscreen will display the option 
to connect to a wireless network, which is vital. Follow 
the on-screen instructions. If you are not using a 
touchscreen, you can follow a step-by-step guide to 
setting up WiFi at magpi.cc/2vBe739. Troubleshooting 
for any problems that may arise while setting up the 
internet connection and installing the OS can also be 
found here. 

You will then need to set up your printer on the 
system by inputting the type of printer, as well as 
its size, shape, and manufacturer. The process is 
fairly foolproof, and you will be guided through 
it step-by-step. 


Using Repetier software 
The majority of the following information will mainly 
apply to those using the official touchscreen to 
interface with their printer. 

Once the internet connection is set up, you will 
see a menu similar to the one shown in Figure 1. 
Navigating these menus will allow you to directly 
control the printer’s motors, as well as viewing 
network settings and sending emergency stop 


3 Repetier-Server Pro 0.85.1 


@ Dashboard 


Free Disk Space: 169.1 GB 


2 


== od 


ing No prin tbr 


am Network 


IP Address 62.75,191.125 


Web Interface itpy/62.75.191.125:.4005 
5 hw . 


Figure 1 Printer control is also accessible via the internet 
over a Local connection on any device 


raspberrypi.org/magpi 


The screen allows access to the printer's 
current status, as well as live settings 
changes and control of the motors 


Tutorial 


commands. One of the best features of the software is 
the fact that you can access the printer remotely via 
the local network by navigating to the Pi’s IP address 
on any device connected to the same LAN. This allows 
you to upload files to the server to be printed, as well 
as allowing you to view the progress of prints and 
cancel them. You can also view a live picture feed of 
the printer if you connect a USB webcam to the Pi. 

For a better experience, installing Repetier- 
Host (magpi.cc/2vBgS4f) on a PC will offer a more 
streamlined process that allows you to slice STL files 
and upload them directly for printing, as well as 
offering built-in direct control of your printer without 
the latency introduced by using a web browser. 


Printing 

As a beginner, it’s easy to feel intimidated by all 
the different file types and methods for printing a 
predesigned object, but there are several industry- 
standard methods that are almost always used. 

Most 3D designs from online sites such as 
thingiverse.com will be in the form of an STL file 
that contains the actual shape data of the object. 

In order to print this design, the file will need to 

be ‘sliced’, which converts the shape into exact 
instructions for the printer’s movements. Slicers 
such as Cura can be found online; however, the 
Repetier-Host software for PC contains a built-in 
Slicer. By slicing the file, the software will generate 
instructions for printing based on your printer’s 
exact parameters, including its size and shape. 

Once the STL file has been sliced, a G-code file will be 
created, which can be uploaded directly to the printer 
and run in order to print the object. 


LIGHTING 


If your 

printer is in 
an enclosed 
space, 
consider 
adding some 
lighting, 
such as LED 
strips. This 
will provide 
illumination 
for the 
webcam, and 
clearer images 
for you. 


INTERNET 
CONNECTION 


A strong and 
stable internet 
connection 
is required in 
order to run 
the printer 
successfully. 
If the 
connection 
is weak, 
consider 
connecting 
the Pi via 
Ethernet. 


September 2017 MdgPi | 49 


Tutorial 


LIVE-CODING 
ONLINE WITH 


riginally created as an interactive and 

fun instructional tool for teaching both 
programming and music, Sonic Piis alsoa 
very powerful tool for creating sophisticated live 
performances as well as algorithmic compositions, 
all by writing code. It’s perfect for people who love 
to code and love to create music, even if they can’t 
play an instrument. Best of all, Sonic Pi is included 
in Raspbian, making it easy to get started with 
coding your own musical creations on your Raspberry 
Pi. Wouldn’t it be great if you could share those 
creations over the internet? In this project, we’ll 
show you how! 


Paho MQTT 
Python Client 
magpi.cc/ 
2vB4txx 


Ruby 
ruby-lang.org 


sonic-pi-cli 
magpi.cc/ 
2vBhoze 


Below Start the 
publisher to send 
the Sonic Pi code 


i tel Cx.) TT VER > © [ialians 
cane 


< ra 
CSD 9 «9 ep GD 69D €=D cp a ae 


Mono 


Tron Bike 
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ONIC PI 


Share your live-coding performances with listeners anywhere 
on the internet using Sonic Pi, some simple Python code, and MQTT 


Sharing Sonic Pi compositions 

For this project, we will assume that you are at least 
somewhat familiar with the Sonic Pi GUI and its 
coding language, and you have at least tried some 
simple code or played with the many examples 
included with Sonic Pi. If not, check out the Essentials 
book, Code Music with Sonic Pi, for some excellent 
beginners tutorials: magpi.cc/1VGIOux. 

Our goal for this project is to give you a way to 
eo beyond playing your Sonic Pi compositions for 
whoever happens to be in the room with you. We’1l 
show how you can share your Sonic Pi coding creations 
with your friends, family, and fans over the internet, 
so they can listen to your musical masterpieces 
virtually anywhere in the world. 

To do that, we have created a couple of simple 
Python programs that can interface with Sonic Pi, and 
communicate with each other over the internet, using 
a lightweight IoT messaging protocol called MQTT. 

MQTT is a publish/subscribe messaging transport 
protocol (in case you are wondering, MQTT originally 
stood for MQ Telemetry Transport, but is no longer 
officially an acronym). It was designed to be 
very lightweight, simple and easy to implement 
and is most commonly used for communication 
in machine-to-machine and Internet of 
Things applications. 
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MQTT 
Publisher 


Python program 
reads the saved 
Sonic Pi code and 
publishes to an 
MQTT broker 


L, 


The main aspect in the publish/subscribe pattern 
is the decoupling of publisher and receiver, where 
the publisher and subscriber don’t know about the 
existence of one another, don’t have to run at the 
same time, and are not halted during publishing or 
receiving. A third component, a broker, is known by 
both parties: this filters and distributes all incoming 
messages by subject/topic. 

For this project, we have created two Python 
programs that use the Eclipse Paho MQTT Python 
client library to implement an MQTT publisher and 
subscriber. The programs use the public Eclipse IoT 
MQTT broker at iot.eclipse.org to exchange messages. 

The publisher program, sp-mqatt-publisher.py, 
is used to read a file that contains Sonic Pi code, 
and publish it to the Eclipse IoT MQTT broker. The 
subscriber program, sp-matt-subscriber.py, is then 
used to retrieve the Sonic Pi code from the broker and 
send it to Sonic Pi for playback. 
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Tutorial 


Subscriber 
Python program 
receives Sonic 

Pi code from the 
MQTT broker and 
sends to Sonic 

Pi CLI 


— 


Sonic Pi CLI 


Sonic Pi CLI connects 
to the Sonic Pi server 
to play the received 
Sonic Pi code 
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Getting started 

To get started, first download the two included Python 

programs, sp-mgtt-publisher.py and sp-matt- 

subscriber.py, and save them on your Raspberry Pi. 
Next, you will need to install the Python MQTT 

client library from the Eclipse Paho project. This 

is easy with the Python package manager, called 

pip, which is included with Raspbian Jessie. Opena 

Terminal window on your Raspberry Pi and enter the 

following command: 


sudo pip install paho-mqtt 


Finally, you will need a way to send Sonic Pi code 
directly to the Sonic Pi synth server, rather than 
typing it into the Sonic Pi GUI. Currently, there is 
no built-in capability to play your compositions 
on Sonic Pi from the command line - although that 
is apparently planned for Sonic Pi 3. Consequently, 
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Right Save the 
composition from 


the Sonic Pi buffer 


to a file, so the 
Python publisher 


program can read 
it and publish it to 


52 


the MQTT broker 


® OF & CO |») sonice El cicrespberypi.~] |aiSave Curent Buffer 


, 


# Tron Bike 
# Coded by Sam Aaron 


use_random_seed 
notes = (ring Name 


8 O x 
Be 


Mono 


live_loop :tron Savein folder 
with_synth :d: 
with_fx(:sl 
with_fx(: 


nl = 
n2 = 


# Coded by Sam Aaron 


use_random_seed 10 


notes = (ring :bl, :b2, :el, : 


we are using sonic-pi-cli, written by Nick 
Johnstone (magpi.cc/2vBhoze). This provides 

a very simple command-line interface, written 

in Ruby, for interacting with Sonic Pi. Luckily, 
Ruby also comes as part of the Raspbian Jessie 
distribution, and sonic-pi-cli should work just 
fine with it. From the Terminal window, enter the 
following command: 


sudo gem install sonic-pi-cli 


Now its time to try a simple 
live-coding performance 
over the internet 


This will install a Ruby script, called sonic_pi, in the 
/usr/local/bin directory on your Raspberry Pi, where it 
can easily be called from the Python code. 


Try it out! 

Once you have these components installed, 

it’s time to try everything out. First, let’s make 
sure that the sonic_pi Ruby program is working. 
Start by opening Sonic Pi. Once the Sonic Pi GUI 

is running, open a Terminal window and enter the 
following command: 


MagPi September 2017 


Create Folder 


itnft 


sonic pi "sample :loop_breakbeat" 


You should hear the breakbeat sample loop that is 
included with Sonic Pi. 

With that working, now it’s time to try a simple 
live-coding performance over the internet, using the 
two Python programs provided. With Sonic Pi open, 
copy one of the code examples included with Sonic Pi 
into a buffer. Then, using the Save button, save the 
buffer to a file. In the screenshot, we have chosen the 
tron-bikes example because, well — who doesn't like 
the sound of Tron light cycles? 

Once the buffer is saved to a file, run the sp-matt- 
publisher. py program from a Terminal window. You 
will need to include two command-line arguments 
when you run the program. The first specifies the 
MQTT topic name that you will publish to. Choose 
something that is simple and likely to be unique. The 
second argument is the name of the code file in which 
you saved the buffer from Sonic Pi. For example, you 
might enter the following command: 


python sp-mqtt-publisher.py saulpimon 
tron-bike.txt 


The publisher program will read the contents of the 
code file named on the command line, and publish 
it to the Eclipse IoT MQTT broker under the provided 
topic name. The publisher program runs an infinite 
loop, and every ten seconds will re-publish the code 
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# Coded by Sam Aaron 


> Starting run 3 


use random seed 10 
notes = (ring :bl, :b2, :el, :e2, :b3, :e3 


live loop :tron do 
with synth :d 
with fx(:slit 


Above The saved file will be published to the MQTT broker 


to the MQTT broker. With each iteration of the loop, 
it will check to see if the code file has been updated 
and, if so, it will re-read the file before re-publishing, 
so that the most recent version of the live-coding 
composition is published to the MQTT broker. 

Now, of course, this isn’t much of a live-coding 
performance without listeners, right? If you have 
a couple of friends who want to help, you can have 
them install the required components as described 
in the ‘Getting started’ section, and run the Python 
subscriber program, sp-mqtt-subscriber.py, to 
retrieve the published code from the MQTT broker and 
play it using Sonic Pi on their own Raspberry Pi. Or, if 
you like, you can run the subscriber program yourself 
on the same Raspberry Pi that you used to publish the 
code. To run the subscriber program, first be sure you 
have installed the Paho MQTT client and the sonic_p1 
Ruby script as described above. Next, open Sonic Pi 
and run the Python subscriber program, being sure to 
specify the same topic name that was used with the 
publisher above as acommand-line argument. For 
example, enter the following command: 


python sp-mqtt-subscriber.py saulpimon 


The subscriber program will connect to the Eclipse 
IoT MQTT broker and retrieve messages that are 
published to the topic named on the command line. 
When a message is received, the subscriber program 
then calls the sonic_pi Ruby script, passing the 
retrieved message as data. The sonic_pi Ruby script 
connects to Sonic Pi and sends it the code, which will 
then be played. Don’t worry when you don’t see the 
retrieved code in the Sonic Pi GUI on the Raspberry Pi 
on which you’re running the subscriber program. The 
sonic_pi Ruby script doesn’t interact with the Sonic Pi 
GUI at all. Instead, it connects directly to the Sonic Pi 
synth server to send the code. 

You are now ready to start sharing your live-coding 
masterpieces over the internet. Simply make changes 
to the Sonic Pi code as you would with any other 
live-coding performance, and save the buffer toa 
file as described above. The simple Python programs 
and MQTT will handle the rest, for you and your 
faithful listeners! 
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>PYTHON 


rpmgtt-publisher.py 


DOWNLOAD: 
import paho.mqtt.client as paho magpl.cc/2VB5FRXx 


import time, os, sys 


topic = sys.argv[1i] 
filename = sys.argv[2] 
host = "iot.eclipse.org" 
client = paho.Client() 


client.connect(host, 1883) 
timestamp1 = -10 
while True: 
timestamp2 = os.path.getmtime(filename) 
if timestamp1 != timestamp2: 
with open(filename, ‘r') as myfile: 
Ffiledata=myfile.read() 
timestamp1 = timestamp2 
client.publish(topic, filedata) 
time.sleep(10) 


rpmgtt-subscriber py 


import paho.mgtt.client as paho 
import sys, subprocess 


def on_message(client, userdata, message): 
pipe = subprocess.Popen("sonic_ pi", stdin=subprocess. 
PIPE, shell=True) 
pipe.communicate(input=message. payload) 
print(str(message.payload.decode("UTF-8"))) 


def on_disconnect(client, userdata, rc): 
subprocess.call("sonic_ pi stop", shell=True) 


topic = sys.argv[1] 
host = "iot.eclipse.org" 
client = paho.Client() 


client.connect(host, 1883) 
client.subscribe(topic, @) 


client.on_message = on_message 
client.on_disconnect = on_disconnect 


print("Press Ctrl-C to stop...") 

ERY: 
client.loop forever() 

except KeyboardInterrupt: 
client.loop stop() 
client.disconnect() 
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PIHUE 


Pimoroni 
Touch pHAT 
magpi.cc/ 
2pafoP9 


Philips Hue 
Bridge and Lights 
magpi.cc/ 
2uBNFsK 


phue Python 
library by 
Studiolmaginaire 
magpi.cc/ 
2uBWOBF 


Below The PiHue, 

with Touch pHAT 
and custom laser- 
cut cover to show 
the colour options 


CONTROL 
PHILIPS 
HUE LIGHTS 


Learn how to control Philips Hue lights with a Raspberry Pi 


and the Pimoroni Touch pHAT 


e’re all guilty of spending too much time 
geeking out! GeekyTim is no exception; he 
spends his time in ‘Hut 8’ (his log cabin in the 
garden) tinkering with Raspberry Pis, 3D printing, and 
laser cutting. His wife complains when she has to come 
out in the rain to call him in! 

After buying some Hue lights, he wondered whether 
they could be controlled with a Pi. Philips provides APIs, 
and other Python libraries have been developed to access 
the Bridge. So, he put them all together and created the 
PiHue — a Raspberry Pi Zero W with Touch pHAT that his 
family can use to call him in from play... 


Setting up 

We start by connecting our Pimoroni Touch pHAT to 
the Pi, burning the Raspbian Jessie Lite image onto 
an SD card, booting up, and connecting to the same 
network that the Hue Bridge is on. 

We need to install a few prerequisites before 
downloading the PiHue code, including Python 3, pip, 
Git, the Touch pHAT library, and the phue library that 
gives us access to the Hue lights from Python: 


sudo apt-get update 

sudo apt-get install python3 python3-pip git 
sudo apt-get install python3-touchphat 

sudo pip3 install phue 
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Next, we need to download the PiHue code 
from GitHub: 


git clone https://github.com/GeekyTim/PiHue 
The PiHue code is in the PiHue directory: 


cd PiHue 


Configuring PiHue 

Each of the Touch pHAT’s six capacitive buttons 

will have a different function. The Back (left arrow) 
button turns the lights on and off; four A, B, Cand D 
buttons flash the lights red, yellow, green, and blue 
respectively; and Enter (right arrow) makes them 
all bright. 


There are two versions of the code: 
> PiHueRoom.py controls a Room as defined 
in the Hue app. 
> PiHueLightList.py controls individual lights in a list. 


The Room version works best with a room that 
contains more than one light, especially if one is 
coloured and one is dimmable. 


We have to edit the code to make some changes 

for our Hue setup: 

> Set the IP address of the Philips Hue: bridgeip. 
We can find this by accessing our router’s IP 
address list or using a network sniffer tool. The 
Bridge’s MAC address can be found in the Hue app. 

> For PiHueRoom. py, set the name of the room to 
be controlled: roomname. 

> For PiHueLightList.py, change the names of the 
lights in the Python list: lights. 


Optionally, we can change the list of Hue xy 


colours by adding to those already listed under 
the comment # Hue 'xy' colours. 
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Above It’s alive! 


We can also change the alert patterns in the section 
following # Alert Patterns. These are Python lists; 
the first number is how many times to repeat the 
pattern. The second is the delay between changes — 
the recommended minimum delay is 0.4 (seconds). 

The remaining values are Python dictionaries of the 
light status changes. 

Use any valid Hue status, e.g. on, bri, xy, ct, 
sat, hue, transformationtime (see the Hue API 
for details: magpi.cc/2vEpXfH). 

Dimmable lights do not accept any of the colour 
changes (xy, ct, sat, hue), so just change their 
brightness instead. 

We can specify as many changes as we want. 

For Light Lists, the status changes are Python 
dictionaries that contain the changes for each light 
type (e.g. Extended color light and Dimmable 


light). Other light types can be added if you have them 


(e.g. Color Light,Color Temperature Light). 

There is one special dictionary that is used by the 
Touch pHAT’s Enter button to set all lights to bright 
white: allwhite. We could redefine this to bea 
preferred colour and brightness. 


Running the code 

The line # b.connect() must be uncommented the 
first time the code is run. Just before running it, we 
must press the Bridge connect button. Run with: 


python3 PiHueRoom.py 
...OF: 
python3 PiHueLightList.py 

The Pi should connect to the Bridge and save the 
Bridge details in the file /home/pi/.python_hue. 
If we ever need to change the Bridge, we just need 


to delete this file. We can now re-comment the 
b.connect() line by adding # at the front.. 
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Running on boot 

There are a few ways to run Python code when 
the Raspberry Pi boots. A good method is to 
use systemd. In this case, we need to create a 
configuration file (aka a ‘unit’ file) that defines 
anew systemd service: 


sudo nano /1ib/systemd/system/PiHue.service 


...and type in the following (replacing PiHueRoom. py 
with PiHueLightList. py if required): 


[Unit] 
Description=PiHue Service 
After=multi-user. target 


[Service ] 

Type=idle 

User=pi 

Restart=always 

ExecStart=/usr/bin/python3 /home/pi/PiHue/ 
PiHueRoom. py 


[Install] 
WantedBy=multi-user.target 


Exit and save using CTRL+tX, Y, then ENTER. 
The permission of the unit file needs to be set to 644: 


sudo chmod 644 /1ib/systemd/system/PiHue. 
service 


We need to instruct systemd to start the service 
during the boot sequence: 


sudo systemctl daemon-reload 
sudo systemctl enable PiHue.service 


When we reboot the Pi, the PiHue service should run. 


Check service status 


We can check the status of the PiHue service using: 
sudo systemctl status PiHue.service 
The last line should look like: 


Jul 10 23:26:52 PiHue systemd[1]: Started 
Start the Touch pHAT Hue controller. 


Sometimes the Raspberry Pi disconnects from 
the network, especially when using WiFi. Once 
disconnected, it will remain disconnected unless the 
interface is restarted or the Pi is rebooted. That makes 
this ight switch a bit useless. But help is at hand: we 
can reboot the Pi if it cannot see your home router! 

Follow the instructions by Thijs Bernolet on his blog 
to enable reboot on network loss: magpi.cc/2uCoiny. 
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>PYTHON 3 


NAME: 


PiHueRoom.py 
PiHueLightList.py 


DOWNLOAD: 


magpli.cc/ 2vBxtol 


CONTROL 
YOUR OWN 
WORLD! 


Don't just use 
the code as 
is - why not 
experiment 
and make 
your lights 
match your 
own colour 
schemes? 


LIGHT 
CHANGES 


For rooms with 
both dimmable 


and coloured 


lights, alter 
the brightness 
as wellas 

the colour of 
the room. 
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YOUR QUESTIONS ANSWERED 


FREQUENTLY 
ASKED QUESTIONS 


NEEDA 
PROBLEM 
SOLVED? 


Email magpi@raspberrypi.org or 
find us on raspberrypi.org/forums 
to feature in a future issue. 


Your technical hardware and software problems solved... 


USING RASPBERRY PIS 
WITH OTHER DEVICES 


PCs 

The Raspberry Pi plays well with PCs (running 
Windows or Linux) and Macs in the same way 

any other computer would — you can set it up to 
view folders and files over the network, and it can 
read all the files from a PC as long as it is running 
compatible software. 


Smartphones and tablets 

Depending on your device, you should be able to connect 
it to the Raspberry Pi to view the contents of its storage, 
in the same way that you would plug the device into a 
PC. Internet tethering over USB can also work, but you 
will need to look up the specific guides for your devices. 


Other Raspberry Pis 

As the Raspberry Pi is a fully functional computer, it 
will interact with another Pi in the same way it would 
interact with a PC or Mac. Many people use multiple 
Raspberry Pis in media setups in their homes, with 
one Pi hosting media files while another Pi plays 
them ona TV or speakers. 


What is a microcontroller? 

A microcontroller is a small piece of electronics 
that, while limited in its function, can be powerful 
enough to control lights, motors and so on with a bit 
of programming. The benefit of a microcontroller 
over a Raspberry Pi is that they typically require 

less power to run. 


Arduino 

Popular tools for creating very small computerised 
projects, Arduinos are cheap and usually use a lot 
less power than a Raspberry Pi. You can find HATs 
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and another add-ons that enable you to connect a 
Raspberry Pi with, and even program, an Arduino. 


Skip the microcontroller 

If power isn’t a problem for you, you can usually 
perform the tasks a microcontroller could do using 
the Raspberry Pi. There’s a huge range of HATs and 
other Pi add-ons that offer extra functionality, such 
as motor control, environment sensing, and even 
higher-quality audio output. 


Controlling electronics 

The Raspberry Pi on its own can control other electronic 
items if you wire them up correctly to the GPIO pins. 
The most basic function is to sense and send on and off 
signals, which could be used to control a game using 
the buttons on an old video game controller. 


Correct components 

Not every project can be made using the Raspberry 
Pi on its own. You may need to use components such 
as thermometers, microphones, light sensors, and 
analogue-to-digital converters. 


Be careful! 

Hacking an existing product may not always work — 
in fact, you may break it or the Raspberry Pi beyond 
repair! Make sure you’ve fully researched your project 
and looked up guides and instructions for similar 
projects before starting yours. 


Above Raspberry Pi can play nicely with microcontrollers 
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YOUR QUESTIONS ANSWERED 


FROM THE RASPBERRY PI FAQ 
RASPBERRYPI.ORG/HELP 


WHAT ARE THE DIFFERENCES BETWEEN MODELS? 
The Model At has 512MB RAM (as of August 2016: earlier 
models have 256MB), one USB port, 40 GPIO pins, and no 


Ethernet port. The Model B+ has 512MB RAM, four USB Raspberry Pi BCM2835  700MHz 512MB. 1 No No 
ports, 40 GPIO pins, and one Ethernet port. Model A+ 
The B+ was superseded by the Pi 2 Model B. The Pi 2 Raspberry Pi 
originally used a 9QOOMHz quad-core ARM Cortex-A7 CPU Model B+ BONAR UN ESA 2 Mee Me 
with 1GB RAM. Some recent versions of the Pi 2 (v1.2) now 
use a Q0OMHz ARM Cortex-A53 CPU. bes pene gooMHz 1GB 4 Yes No 
The Pi 3 Model B was launched in February 2016. It uses 
a 1.2GHz 64-bit quad-core ARM Cortex-A53 CPU, has 1GB Raspberry Pi BCM2837 ee ice AGB Z vets ee 
RAM, integrated 802.11n wireless LAN, and Bluetooth 4.1. 3 Model B 
The Pi Zero and Pi Zero W are half the size of a Model A+, Raspberry Pi 
with a 1GHz single-core CPU and 512MB RAM, mini-HDMI Fee Somes boar leis Ne Ne 
and USB On-The-Go ports, and a camera connector. The 
Pi Zero W also has integrated 802.11n wireless LAN and uocene a BCM2835 1000MHz 512MB 1 No Yes 


Bluetooth 4.1. 


KEEP MULTIPLE 
PROJECTS IN 
ONE PLACE 


WD PIDRIVE FOUNDATION EDITION 
MADE FOR RASPBERRY PI 


Our custom NOOBS software enables you to install 
multiple work spaces for up to 5 projects that can all be 
managed from the WD PiDrive. 


CHOOSE THE 
STORAGE THAT'S 
RIGHT FOR YOU: 


USB FLASH 64GB 


Includes microSD™ card 
with starter software 


$18.99 


USB HARD DRIVE 
250GB /375GB 


Includes microSD™ card with starter 
software and WD PiDrive Cable 


Starts at $28.99 


@ WD LABS Learn more at wdlabs.io/mp60b 


Western Digital, WD, the WD logo, WDLabs, and the WDLabs logo are registered trademarks or trademarks of Western Digital Corporation or its affiliates in the U.S. and/or other countries. Raspberry Pi is a trademark of the Raspberry 
Pi Foundation. microSD is a trademark of SD-3C, LLC. All other marks are the property of their respective owners. As used for storage capacity, one gigabyte = one billion bytes. Total accessible capacity varies depending on operating 
environment. Product specifications subject to change without notice. Pictures shown may vary from actual product. © 2017 Western Digital Corporation or its affiliates. 
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LEARN PROGRAMMING ~ 
— 


Special $10 MagPi coupon: 


only at BuildPiper.com 


‘It’s a really fun educational computer kit 
that should really impress those who love 


Minecraft and building stuff” Mii ° 
cigft 


Want to learn how to bring Piper to your school? 


buildpiper.com/EDU 


=] . - y : 
SOFTWARE-BASED CURRICULUM = CREATE YOUR ELECTRONICS 


Supported by Top University Funds 
I i Stanford-StartX Fund 


AEF of Princeton University 


Available at: 


BuildPiper.com amazon ys$qu BARNES <cNOBLE 


ee, 


~ARDUINO&&S 
RASPBERRY PI 


Combine the ease and accuracy of Arduino with the advanced capabilities 
of a Raspberry Pi for the best in physical computing projects 
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f you want your next project to break beyond 
the limits of code and screens, you might want 
to consider adding an Arduino board to your 
Raspberry Pi. These simple, cheap controllers come in 
all shapes and sizes and allow you to easily measure, 
monitor, and manipulate the physical world. 

Arduinos are microcontrollers that make physical 
computing projects quick and easy to build. Whether 
you’ re flashing LEDs, activating motors, or sensing 
changes in the real world, an Arduino is worth 
considering as part of your project. 

This tutorial will take you through the first steps 
of using an Arduino, and provide examples of fun 
and useful projects to make. Whether you’ re building 
a weather station, constructing a robot, making an 
alarm for your bedroom, or planning an automatic 
watering system for the greenhouse, Arduino and 
Raspberry Pi make a powerful tag team. 
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ARDUINO UNO 


The Arduino Uno looks like a smaller 
Raspberry Pi board, but works 
differently. While the Raspberry 

Pi is a versatile computer, the 
Arduino board is a highly 

focused microcontroller. 


RESET BUTTON 


On one corner of 
the Arduino board 
sits a reset button 


USB TYPE B 


The larger USB Type 
B connector on the 


Arduino is used to draw 
power, and provides a 
connection between 
the Raspberry Pi 

and Arduino 
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ARDUINO 


feature 


DIGITAL 1/0 
The Arduino has 14 digital 
input/output pins (female 
header) of which six can be 
used as PWM (pulse-width 
modulation) outputs to control 
devices such as servos, RGB 
light Levels, and other devices 
that need precision 


MICROCONTROLLER CHIP 


An ATmega328P microcontroller 
is used to control the hardware 
on the Arduino board. It 

is programmed using the 
Arduino IDE (accessed via the 
Raspberry Pi) 


ANALOGUE INPUTS 

On the lower half of the Arduino 
Uno are six analogue input pins 
(female header). These can be 
used to read information from 
devices such as potentiometers 
and photoresistors 


QUARTZ CRYSTAL 


A 16MHz quartz crystal 
chip is included on the 
board. This helps the 
Arduino control devices 
with precision 


Use one of the USB Type A ports 
on the Raspberry Pi to provide 
power to the Arduino. You'll 
need a USB Type A to B cable 


September 2017 MdgPi | 51 


—,—— 


ow you know what an Arduino is, you’!] want 
to discover how to connect it to a Raspberry Pi 
and use it. We’re using an Arduino Uno witha 
Raspberry Pi 3 for this guide, but the steps are similar 
for all models. 

The first step in programming an Arduino board is 
to install the Arduino IDE (integrated development 
environment) on your Raspberry Pi. This program 
checks code and loads it onto the Arduino. Install the 
latest version of Arduino IDE using apt: 


Alternatively, open Chrome on your Raspberry Pi, 
head to magpi.cc/2tPw8ht, and click the Linux ARM link 
under ‘Download the IDE’. Extract the file to your /opt 
directory , then open a Terminal and run the install.sh 
Script to install. 


Power the Arduino 
from one of the Pi's 
USB ports; this also 
enables two-way 
communication 


Use the digital 
GPIO pins of the 
Arduino to control 
the electronics 


Arduinos have 
specific inputs to 
receive analogue 
information from 

devices such as our 
PIR motion sensor 


ARDUINO UNO LEDS RESISTORS 


magpli.cc/2tPLngE | magpi.cc/2tPT7sU | magpi.cc/2tPNye1 | magpi.cc/2tPynl9 


CLIVE WEBSTER 


Pi around the house - how many Pi 
boards is too many? 
twitter.com/clivewriting 


, A professional tinkerer since 2004, 
See Ne Clive just keeps seeing more uses for 


ARDUINO 


You will find Arduino IDE under Menu > 
Programming. Open the app to start programming your 
Arduino board. 


SKETCH YOUR IDEAS 

Arduino programs are called ‘sketches’, and are based 
on the C programming language. Open the IDE and 
you’ll see a blank sketch, with the two basic areas for 
code: void setup() and void loop(). If you see an 
empty script, choose File > Examples > 01.Basics > 
BareMinimum. 

As the comments explain, void setup() is for code 
that runs once to set up your electronics properly. The 
code you type into void loop() will repeat from the 
first line to the last in an endless loop. 

To demonstrate, we’ve written a basic sketch that 
flashes two LEDs when you move your hand over a PIR 
sensor. Connect the two LEDs and PIR sensor to the 
Arduino, as shown in the circuit diagram (Figure 1). 

Once you’ve wired up the Arduino to the circuit, attach 
it to one of the Pi’s USB ports. This provides power 
to the Arduino, as well as a data connection between 
your Raspberry Pi and the Arduino board. Do not use 
the Arduino’s barrel-jack power input — a Pi 2 or 3 can 
supply enough power for an Arduino board over USB. 

Enter the code from PIRBlink.ino and save it as 
PIRBlink using File > Save. It will be saved inside the 
Arduino directory in your home directory. 

We use the pinMode instruction to tell the Arduino 
which GPIO pins the LEDs are attached to (pins 5 and 6) 
and that each pin should be treated as an output. 

In the void loop() section, we tell the Arduino to 
raise the voltage on these pins to HIGH (5 V) with the 


RESISTOR CALCULATOR | PIR MOTION SENSOR 
magpi.cc/2diJivg 
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Figure 4 Circuit diagram 
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The motion sensor 
requires 5 V to run, but 
outputs either o V (no 
motion) or 3.3 V (when 
motion is detected) 


digitalWrite instruction, then to pause for half a 
second, and then to turn off the LEDs. 

Before uploading your sketch to the Arduino, tell 
the IDE which Arduino board you’re using by opening 
Tools > Board. Then tell the IDE which port to use to 
upload your code by opening Tools > Serial Port and 
selecting /dev/ttyACMo. On version 1.8.3 of the IDE, 
you need to select the version marked ‘(Arduino/ 
Genuino Uno)’. 

Now click Upload to program the Arduino with your 
sketch. After a few seconds of code-checking and 
uploading, you should see your LEDs flashing whenever 
you move your hand over the sensor. 


LOOKING AT THE CODE 
While not necessary, it’s also good Arduino sketch 
etiquette to include a description at the start. 

At the top of your sketch, type /* and hit ENTER: the 
IDE will add two more lines. Anything written between 
the /* and */ will be ignored by the Arduino, but can be 
read by any humans wanting to understand what your 
sketch does and how it works. 

We’ve used variables for our LEDs, meaning that if 
we change the GPIO pins they’re attached to, we’ll have 
fewer edits to make. 

We tell the Arduino IDE the type of variable, then the 
name, and the value. So our LED pins are int led1=5;. 
By replacing all instances of 5 with led1, any changes 
to our build require only one change to our code. 


ADD MOTION 

We’ve also added a PIR (passive infrared) motion 
sensor, as Shown in the circuit diagram (Figure 1). 
We therefore declared the variable int motion = 3 
and added this line to void setup(): 


pinMode(motion, INPUT) ; 


Finally, we added some code to make the motion 
sensor trigger the LED flashes: 


if (digitalRead (motion) == HIGH) { 


raspberrypi.org/magpi 


ARDUINO RASPBERRY PI 


Connect the Arduino 
to your Raspberry Pi 
using the USB socket 
(after you have set up 
the rest of the circuit) 


x=< <« « « « « 


eee eeeee *-* 


PIRBlink.ino 
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/* 
* Blinks two LEDs when motion detected 
[7 


//variables 
int ledi = 5; 
int led2 = 6; 
int motion = 3; 

int wait = 500; //5@0ms = 1/2s 


void setup() { 


// put your setup code here, to run once: 


pinMode(led1, OUTPUT) ; 
pinMode(led2, OUTPUT); 
pinMode(motion, INPUT) ; 


r 


void loop() { 


eeeeeneeeeeeeeee 
eoeeesvsseeeeee#e8teee 
eoeeeoecesesezsessesesertsee 
eeeseeseeeseese¢#8e8ee?egeeepeesees 
eo*eeeeeeeeee eee ¢ 
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// put your main code here, to run repeatedly: @ 


if (digitalRead(motion) == HIGH){ 

digitalWrite(led1,HIGH) ; 
digitalWrite(led2,HIGH) ; 
delay(wait) ; 
digitalWrite(led1, LOW) ; 
digitalWrite(led2, LOW) ; 
delay(wait) ; 

I 


As with the if statement, this is part of the 
void loop() section that will run continuously, 
meaning the motion sensor will be read — or polled — 
repeatedly for signs of motion. 

A final note on coding with Arduino: every line of code 
must end with either a semicolon or a curly bracket. The 
IDE will highlight any line of code that suffers an error, 
and typically it’1l be because the previous line lacks its 
semicolon terminator. 

If you are unfamiliar with the C programming 
language, there are lots of resources you can find online 
to learn how to use it. 


LEARN TO 
CODE WITHC 


Arduino uses the 

C programming 
language. To get 

up to speed with C, 
read our Essentials 
Guide: Learn to Code 
with C. 

magpi.cc/ 
learn-c-book 
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LEARN 
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WT 
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GET THE 


SerialLightsRespond.ino 
Arduino IDE | magpi.cc/arduinoandpi 


/* 
* Blinks LEDs when motion detected. 
* LED blink repetition determined 
* by amount in serial_respond_pi_side.py 
a7 


//variables 
int ledi = 5; 
int led2 = 6; 
int motion = 3; 

int wait = 500; //500ms = 1/2s 


void setup() { 
// put your setup code here, to run once: 
pinMode(led1, OUTPUT); 
pinMode(led2, OUTPUT); 
pinMode(motion, INPUT) ; 
Serial.begin(960@) ; 


} 


void loop() { 
// put your main code here, to run repeatedly: 
if (digitalRead(motion) == HIGH) { 
if (Serial.available()) { 
flash(Serial.read() - '@'); //Converts 
Serial message into a number 
} 
} 
delay(50@0) ; 


} 


void flash(int repetitions) { 
for (int i = 0; i < repetitions; i ++){ 

digitalWrite(led1, HIGH) ; 
digitalWrite(led2, HIGH) ; 
delay(wait) ; 

digitalWrite(led1, LOW) ; 
digitalWrite(led2,LOw) ; 
delay(wait) ; 
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RASPBERRY PI 
AND ARDUINO 


TO CHAT 


Now that we can program an 
Arduino with a Pi, let’s get the 
two talking to each other 


t is possible to make commands from the Pi 
(automated or human-activated) affect the 
sketch loaded onto an Arduino; and for data 
collected by the Arduino to be sent automatically to 
the Pi to be processed. 

By why would you want to? It’s a fair question, as 
the Pi has plenty of GPIO headers to attach motors, 
sensors, LEDs, and other devices — why add the 
complication and expense of a second board? 

The answer lies in the simplicity of an Arduino 
board. It’s an easily programmable microcontroller 
with clearly labelled GPIO pins. An Arduino board 
therefore has very little overhead to prevent it from 
taking millisecond-accurate readings, and there’s 
nothing much to go wrong and cause an Arduino to 
Stall or hang. 

The Raspberry Pi, meanwhile, has all kinds 
of hardware and software overheads - from 
USB controllers and display outputs to wireless 
connections and a full-blown operating system. All of 
these can lead to delays or jitters in measurements. 

Most Arduino boards have analogue inputs, and can 
supply a wide range of voltages rather than the 3.3 V 
or 5 V that a Pi offers. This makes it much easier to 
connect and code for many electronic components. 


SERIAL COMMUNICATIONS 

The standard method of communication between a Pi 
and an Arduino is serial: it’s robust, simple, quick and 
easy. Let’s start with the Arduino, turning our basic 
sketch into an alarm system. 

First, re-save the PIRBlink file, renaming it 
SerialFlashLights. Now, we need to enable serial 
communication, so we head to the end of the void 
setup() section and add: 


Serial .begin(9606) ; 
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Left The Arduino 
sketch (on the left) 
includes a serial 
read function that 
gets data from the 
Python code (on 
the right) 


Most Arduino boards have analogue inputs, 
and can supply a wide range of voltages 
rather than the 3.3 V or 5 V that a Pi offers 


The capital S is required (serial.begin() won't SerialFlashLights.ino 

work, so the instruction won’t turn orange), while Arduino IDE | magpi.cc/arduinoandpi 

the number sets the speed. Serial connections are 

measured in baud, with a typical speed of 9600 baud, /* 

or 9,600 bits per second. * Blinks two LEDs when motion detected and 
Next, we need to set up some way of outputting * sends serial message to serial_flash_pi_side.py 

data from the Arduino over this newly opened serial * / 

communication. This is fairly easy: just add the line 

Serial.println (message); inthe void loop() //variables 

section. The classic message would be hello world, int led1 = 5; 

but we can skip straight to something more useful int led2 = 6; 

with the line: int motion = 3; 


int wait = 500; //5@0ms = 1/2s 
Serial.println ("Motion detected!"); 
void setup() { 
// put your setup code here, to run once: 
pinMode(led1, OUTPUT) ; 
pinMode(led2, OUTPUT) ; 
pinMode(motion, INPUT) ; 
Serial.begin(960@) ; 


We can even test that new code without having to 
write any code for Pi just yet. Upload the sketch to the 
Arduino and then click the Serial Monitor button at 
the top right-hand side. You should see the ‘Motion 
detected!’ message whenever you wave your hand at 


the sensor. y 
void loop() { 
ARDUINO TO PI // put your main code here, to run repeatedly: 
Now we can switch to writing a Python script on if (digitalRead(motion) == HIGH) { 
the Pi. We’ll use Thonny, the new Python IDE for Serial.println("Motion detected!"); 
Raspbian. If you haven’t got Thonny yet, install it with digitalWrite(led1,HIGH) ; 
this code: digitalWrite(led2,HIGH) ; 
delay(wait) ; 
sudo apt-get update && sudo apt-get install digitalWrite(led1, LOW); 
thonny digitalWrite(led2, LOW) ; 
delay(wait) ; 
Once installed, fire up Thonny. Enter the code from } 
SerialFlashLights.ino into Arduino IDE and serial_ } 


flash_lights_pi_side.py into Thonny. Make sure you 
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in Thonny. Now when you wave your hand, the lights 
will flash and a message will appear in the Thonny 
Shell that reads ‘Arduino says: Motion detected!’. 


With a bit of practice, you'll 
be capable of developing 


some great projects 


OOKING AT SERIAI 
First we import the Python serial library with import 
serial. We then need to define the serial connection 
with the Arduino: 


serialMsg = serial.Serial('/dev/ttyACMe', 
9600, timeout = 1) 


Note that you could use any name rather than 
serialMsg. The first argument is the port that the 
Arduino uses, the second is the baud rate of the serial 
connection, and it’s best to specify a timeout to 
prevent overloading. 
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upload the code to Arduino first, then run the program 


import serial 


serialMsg = serial.Serial("/dev/ttyACMe", 
9600, timeout=1) 


while True: 
rawMsg = serialMsg.readline() 
message = (rawMsg.decode().strip() ) 


if (message == "Motion detected!"): 
print("Arduino says: Motion 
detected!") 


Next, we read the serial link with the line 
serialMsg.readline(). However, the serial 
connection will change the encoding of the Arduino’s 
message into something unusable. We need to encode 
the message and strip the extra characters added 
if we’re to use the Arduino’s readings to trigger an 
action in our Python script. That’s what the message 
variable does in the SerialFlashLights.ino code. 

You can replace the mundane print line with almost 
anything you can think of to make any sensor on the 
Arduino trigger any kind of event. If your Arduino uses 


The ATmega328P CPU has very 
littLe overhead, so it can take 
millisecond-accurate readings. 
There's not much that can go 
wrong and cause an Arduino to 
stall or hang (and if it does, it 
automatically reboots and runs 
the program). 


Because the Arduino has 
lower software overheads, 
it's a useful add-on tool for 
sending precise readings to 
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Serial connections are used to 
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send and read messages to and 
from each device. The messages 
are sent via the USB cable that 
connects the two devices. 
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serial_respond_pi_side.py 
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many sensors, use a different serial message for each 
so that the Python script can tell which action to take. 


PI TO ARDUINO 

Having the Arduino react to inputs from the 
Raspberry Pi is slightly less complicated. In 
SerialLightsRespond.ino we’ ve defined our own 
function, flash(). Inthe void loop() section, 
the flash function’s variable repetitions will be 
replaced by the number received (and converted) 
from the Pi, meaning the lights will flash according 
to the number output by the Pi. 


In serial_respond_pi_side.py we use serialMsg. 


write(b'7' ) to tell the Arduino to flash the LED 
lights seven times. The b is required to properly 


The Raspberry Pi packs far more 
processing power than the 
Arduino Uno. This enables the 
Raspberry Pi to run a full Linux 
desktop interface, and manage 
the higher-level functions. 


The Raspberry Pi can 
communicate with the 
Arduino using serial 
communication. Open a port 
between the Arduino and 
the Pi in code (libraries are 
available for Python and C). 


The Raspberry Pi’'s HDMI and DSI video 
output ports enable it to run a visual 
interface. They can therefore be used to 
turn the Pi into a controller for the Arduino. 
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ARDUINO 


encode the message for the Arduino to interpret; 
whether you send text or numerals, they must be 
placed within quotes. 

Unfortunately, whether you send letters or 
numbers, they all arrive as characters — even 
serialMsg.write(b'1' ) will be received as the text 
character 1 rather than a number. 

If you’re sending letters to the Arduino, that’s not 
a problem. However, if you do want to send numbers 
— perhaps to tell the Arduino to flash its LED a 
certain number of times — you need to convert the 
numerical character into a numerical number using 
- @, as in our SerialLightsRespond.ino code. 

When you wave your hand in front of the PIR 
motion sensor, the LED lights will flash seven times. 
Adjust the 7 to any number you want in the Python 
code, and the LED lights will respond accordingly. @ 


READY TO GO 

You’ve linked an Arduino to a Raspberry Pi and 
discovered how to control its input/output pins, how 
to read information from the Arduino, and how to 
send messages from the Raspberry Pi to the Arduino. 
With a bit of practice, you’ ll be capable of developing 
some great projects. 
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An entire city, built from Lego and controlled by 
Arduinos, Raspberry Pis, and bundles of sensors. 

All the parts interact with each other, with myriad 
sensors placed around the blocky cityscape to track 
events within the city and in the real world. The whole 
connected city is powered by a Raspberry Pi running the 
Node-RED Internet of Things manager (nodered.org). 
internetoflego.com 


ARCADE CABINET MI D SMART HOME 


For his ‘HAMMOND’ smart home system, Paul Sieradzki 


Galaga. That 1981 arcade game of champions. While you can play used an Arduino Mega to manage everything from 
Galaga in your browser (freegalaga.com), nothing beats the look of motors that roll blinds, temperature sensors and PIR 

a light-up arcade cabinet, complete with sticks and giant buttons. In motion sensors, to relays to control power, IR blasters, 
fact, Hamburg’s Alex Weber went even further, rescuing an old CRT and RFID readers. There’s a Pion top to gather weather 
television from a skip to connect to a Pi running information, add web access, and manage Alexa-based 
MAME through RetroPie (retropie.org.uk). voice recognition. A second Pi serves video and music. 


magpi.cc/2vb6NPe 
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Tijuana Rick (aka Ricardo Cortez) used an Arduino Mega to 
transform a 1969 Wurlitzer 3100 jukebox into a digital retro music 
box. He had to go the digital route because, while the jukebox still 
worked, the previous owner kept all the vinyl records. The Arduino 
monitors the jukebox buttons, sending a serial output to the Pi, 
which handles the music playback. 


As part of a HackPrinceton hackathon, Bonnie Eisenman 
created stairs that play a tune. Each step is fitted with a 
light on one side and a light sensor on the other; when a 
foot breaks the beam, an Arduino passes the number of 
the step to a Raspberry Pi, triggering a specific note to be 
played through a set of speakers. 
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FlipFrame solves the problem of 
showing a slideshow of mixed- 
orientation images. Obviously, 
black bars are insufferable, so Tim 
Giles uses a Raspberry Pi to analyse 
his slideshows. If the resolution 
indicates a landscape image, the Pi 
tells a motor-governing Arduino to 
turn the FlipFrame’s 27-inch screen 
from landscape to portrait mode. 

It is a sight to behold. 
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Waker 
days 


Tiny 4WD 


iS a small 


but powerful 


robot that 
you build 


yourself 
Coretec 


GOPIGO 3 


Amore 
expensive kit, 
but it does 
come with 
sensors for 
some proper 
robotics. It's 
even easier for 
newbies as well. 


ee 


‘er 


| 
£95 /$99 
magpi.cc/2vpUPP8 
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TINY 4WD ROBOT KIT 


f you cast your mind back 
to issue 51 of the magazine, 
you’ll remember a robot 
on the cover that you could make 
yourself. Its designer, Brian 
Corteil, has taken the lessons from 
making that robot to build an all- 
new improved version, which you 
can buy directly from his Coretec 
website (magpi.cc/Tiny4WD) and 
from pimoroni.com. 

The Tiny 4WD is the end result 
of this learning process, and is 
available as a kit that you build 
yourself. All you need to supply 
is a Raspberry Pi and a way to 
power it (a mobile USB battery 
charger will do the trick). The 
kit is optimised for a Pi Zero, 
with specific mounting points on 


the chassis. However, we tested 
it using a Raspberry Pi 3 and it 
worked well. 


Easy build 

The build is fairly quick. There 
are only three parts to the 
chassis, and one of these isn’t 


TINY 4WD 
ROBOT KIT 


Rob Zwetsloot looks at a tiny robot with a lot of power, 
in a kit based on a robot you might remember from the magazine 


online, linked from the Pimoroni 
website: magpi.cc/2pXHCu8. 
Online instructions aren’t ideal 
— it would be nice to have printed 
instructions in the box - but it’s 
enough to get you Started. 

We managed to get the robot 
up and running in just under two 


The kit 1s optimised for a P1 
Zero, with specific mounting 
points on the chassis 


necessary in its basic state. The 
box recommends using the build 
in The MagPi as your instructions, 
but they don’t quite fit this kit. 
Luckily, there’s a great guide 


episodes of Brooklyn Nine-Nine, 
so we’d estimate 30-40 minutes’ 
build time, but it may take longer 
depending on your skills with 

a soldering iron. You’ll need to 
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solder a 40-pin and a 20-pin 
header to the Explorer pHAT 
supplied with the kit, as well as 
soldering a GPIO header to the Pi 


Zero. The rest of the setup is easy: 


install the software on the Pi Zero 
(running Raspbian) and you’re 
ready to play! 


Flexible control 

From here you can use the test 
scripts to control the robot 

using a USB controller, or start 
making it more autonomous. The 
Pimoroni library for the Explorer 
pHAT is easy to understand — 

So, with the docs open and the 
examples to hand, you can easily 
Start creating your Own programs. 

Each side of the Tiny 4WD is 
powered by one of the motor 
outputs on the pHAT. This 
means that, for example, both 
left wheels will always run at 
the same speed and direction as 
each other. This makes it easy to 
turn on the spot, and gives it full 
power when it’s moving forwards 
and backwards. 

The Tiny 4WD is easy to 
customise. There are extra inputs 
and outputs on the board, so 
you can start adding additional 
sensors. There’s a camera mount 
that could be used to attach an 
ultrasonic sensor, or a Raspberry Pi 
Camera Module - like the robots in 
the Formula Pi racing series. 


Power choices 

Choosing a power supply can be 
tricky. The idea is to house your 
power source between the layers 
of the chassis. However, the 
narrow gap, partly blocked by the 
wires to the motors, limits the 
size of any power supply. You’ll 
also need to think about power 
capacity — the motors will be 
powered from the Pi’s GPIO pins, 
so your Pi will need more power 
than you might expect. 
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Thumbs up 

We do like this robot overall. The 
build quality is great, with a sturdy 
chassis made from thick acrylic, 
decent micro motors supplied with 
the kit, and the inclusion of a great 
motor controller in the Explorer 
pHAT. The soldering requirements 
make it unsuitable for an absolute 
beginner, but it’d be great as a step 
up for novices. It could even be 
used as a base by more advanced 
robotics users, as you can easily 
swap out the HAT and use a bigger 
Pi to add more functionality. 


Unfortunately, supplies are 
limited for this kit, but more 
units are being made all the time. 
If you want one, you may just 
have to be patient. We think it’s 
worth the wait, though. 


fast word 


A great little robot kit which could do with some 
better build instructions. Once it's built, however, 


you have a lot of options and plenty of ways to 
make it your own. 
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Maker 
says 
Connect 
RGB LED 
shapes. 
Sculpt your 


lights 
RasPi0 


RASPIO INSPIRING 


From £10/$13 


RASPIO INSPIRING 


Create impressive illuminations with this dazzling range of light kits 


MOTE 


Instead of 
daisy-chaining, 
each super- 
bright LED strip 
(no shapes) 

is connected 
separately toa 
PpHAT or USB- 
connected host. 


P 


4 


From £16/$21 
magpi.cc/2g9iyLs 
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he main selling point of 
RasPiO InsPiRing is the 
ability to daisy-chain a 
variety of LED strips and shapes 
together to create 2D and even 
3D displays. Now headed for 
general sale following a successful 
Kickstarter, the range comprises 
four kits: a strip of eight LEDs 
(£10/613), a circle or triangle 

of 24 LEDs (£20), an NTP Clock 
kit including Pi Zero (£30), and 
a pyramid kit featuring three 
24-LED triangles (£50). 

Although the super-bright 
APA102c LEDs can be controlled by 
other devices — including Arduino, 
ATtiny, and ESP8266 -— each kit 
comes with a pHAT-sized driver 
board for the Pi, communicating 
via SPI. Assembly takes around 20 
minutes and involves soldering on 
a 40-pin header, two small female 
headers, and a socket for a buffer 
chip. The chip translates the Pi’s 
voltage to 5 V logic to drive the 
LEDs. The power supplied by the Pi 
alone should be enough for most 
projects, but there’s the option 
of boosting it with an external 5 V 
power supply if needed. Jumper 
wires are supplied for connecting 


the light strips and shapes to the 
Pi, along with a couple of optional 
10 kQ resistors (not needed in most 
cases). There’s also the option of 
a header for analogue inputs, so 
you could control your lights with 
potentiometers, for instance. 
Male and female four-pin 
connectors are supplied for each 
LED strip and shape, enabling you 
to daisy-chain units together. 
Three sets of input/output holes 
are provided at each end, so you 
can solder your connectors at 
various angles: 180°, 90°, or 45°. 
This offers more flexibility when 
connecting units to create custom 
light displays, although you can 
always just wire directly to the 
holes if you prefer. 


Indeed, that’s what you’ 1l 
be doing for the pyramid kit. 
After assembling the 3D shape 
from three triangles, held 
together using pieces of sticky 
tape, you’ll need to solder bare 
wires between the input/output 
holes at each vertex, which is 
fairly fiddly. 

Once the hardware is assembled, 
the software is installed on 
the Pi with a single command 
and includes a range of Python 
examples which can easily be 
adapted for your own purposes. 


fast word 


This range of LED lighting 
kits offers flexible daisy- 
chain connectivity that 
enables makers to ‘sculpt’ 
custom arrangements of 
shapes. The end results are 


impressive: the super-bright 
LEDs creating some dazzling 
displays. The pyramid is a 
particularly fun (if fiddly) 
project to make, and would 
make a great gift. 
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STRATO PI CAN 


Maker 
says 
Makes 
Raspberry 
Pi more 


professional 


SferaLabs 
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£106 / $138 


STRATO Pi CAN 


Lucy Hattersley looks at an industrial solution for Raspberry Pi 


PICAN 2 


This PiCAN2 
board provides 
CAN bus 
capability for 
the Raspberry 
Pi. It uses the 
Microchip 
MCP2515 CAN 
controller with 
a MCP2551 CAN 
transceiver. 


£33 / $47 
magpi.cc/2ut8ftb 
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he Raspberry Pi has 

slowly been making its 
way from the digital 
hobbyist’s garage into professional 
manufacturing environments. 
SferaLabs specialises in smart 
control systems, and its Strato Pi 
boards are a great attempt to add 
commercial-grade hardware to the 
Raspberry Pi board. There’s a range 
of different boards available, and 
we’ re looking at the top-of-the 
range CAN board, which has all the 
bells and whistles. 

Most of the Strato Pi boards 
accept 9-28 V, while this board uses 
9-65 V DC power. A high-quality 
power supply ensures reliable 
operation of a Raspberry Pi when 
it’s being used 24/7. The board has 
a step-down converter to provide 
the 3 A continuous output. It also 
features power surge protection (up 
to +500 V, 2 ohms, 1.2/50 us). 

The CAN board also features 
UPS (uninterruptible power 


supply). In the event of power 
loss, it offers enough time 

to save data and perform a 
clean shutdown. 

Another nifty feature is 
Hardware Watchdog, which 
monitors the software running on 
the Pi. The Strato Pi Can monitors 
a GPIO 5 heartbeat pin (which takes 
less than 60 seconds to change 
state). If it doesn’t see a change, it 
initiates a shutdown procedure and 
raises GPIO 12 to HIGH, which can 
signal to your code that a watchdog 
timeout has occurred, allowing you 
to run a Script. 

On the end of the Pi CAN board 
is an 11-position terminal block. 
Power runs into this block, and it 
provides a CAN (Controller Area 
Network) bus and RS-485 ports, 
both of which can be used at the 
same time. The CAN controller is 
used in automotive environments, 
and you can use it to interface with 
a car’s internal network. 


Eight of the GPIO pins are used 
to control the real-time clock, 
CAN controller, buzzer, and for 
power management; but you can 
still use the remaining pins for 
pass-through control. You can 
view circuit diagrams and find 
usage instructions in the user 
cuide (magpi.cc/2ut7y33) and 
schematics (magpi.cc/2ut6z34). 

A Strato Pi utility is used to 
control the buzzer, watchdog, 
and UPS, installed using: 


sudo wget http://sferalabs. 
cc/files/strato/strato 


fast word 


Strato Pi CAN is a high-quality 
board, with specific features 


for use in a production 
environment. 
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pimoroni.com/inkyphat 


PAPIRUS 
ZERO 


Available ina 
range of sizes, 
this black- 
and-white elnk 
display has a far 
faster refresh 
rate, plus push- 
buttons to 
control what's 
shown on 
screen. 


£27 /$35 
magpi.cc/20u5KTh 
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Waker 
says 


A low- 
energy, high- 
falutin, red/ 
black/white 
electronic 
paper display 


for your Pi! 
Pimoroni 


INKY PHAT 


Add a little more colour to your e-Ink display, says Phil King 


ith the ability to display text 
and images that remain 

on screen without using 

a power supply, e-Ink displays are 
ideal for saving precious battery 

life in portable projects. They’re 

also much easier to view in bright 
sunlight than conventional screens. 

Until now, Pi e-Ink displays 
have been black and white — but 
the tri-colour Inky pHAT injects a 
bright shade of red into the mix. 
This certainly adds a dash of extra 
interest to images, such as the logo 
shown on the display when you 
unpack your pHAT. 

Unlike the rival PaPiRus Zero, 
the Inky pHAT comes fully 
assembled, with the e-Ink screen 
already mounted and connected to 


— the board via a small ribbon cable. 


This saves fiddling about with a 
thin and fragile screen, although 
you still have to take care not to 
press on it when mounting the 
pHAT on the Pi’s GPIO pins. 


While the Inky pHAT has a 
Zero form factor, it'll happily 
work with any 40-pin Pi model. 
Communicating via SPI, it only 
uses six GPIO pins (plus 3 V and 
5 V power). If you wanted to 
locate the screen away from the 
Pi, however, you’d need to use 
something like a Black Hat Hack3r 
(magpi.cc/2fqGyoD). 

A single Terminal command 
installs all the software required. 
The Python library comes with a 
few helpful examples, including 
a calendar and a weather display. 
There’s a lot of flashing and 
pulsing as the screen refreshes, 
the red parts usually appearing 
last. While the end result looks 
vibrant, the downside is a much 
slower refresh time compared 
with a monochrome e-Ink screen 
— typically around 15 seconds 
vs 1 second or less. The badge 
example takes even longer, but 
demonstrates the ability for a 


partial update, adding text (your 
name) to a background image. 

The slow refresh rate makes the 
Inky pHAT unsuitable for scrolling 
text, but static text can easily be 
displayed in any installed TrueType 
font, using a simple message 
function in Python. Images area 
bit trickier, as you need to prepare 
them in a special indexed colour 
mode, and they must also exactly 
match the size of the display 
at 212 x 104 pixels. 


fast word 


While the slow refresh rate 
makes the Inky pHAT unsuitable 
for some projects, it does look 
far cooler than a standard 


monochrome elnk display. If 
you want a low-power, battery- 
saving screen with a little more 
pizzazz, this is the one to get. 
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Maker 
says 
A high- 
resolution, 
high-speed 
3.5-inch 
TFT display 
for your 


Raspberry Pi 


Pimoroni 


ADAFRUIT 
PITFT PLUS 
3.5-INCH 
This 480x320 
screen also 
plugs into the 
GPIO pins, but 
only uses eight 
of them. It has a 
resistive, rather 
than capacitive, 
touch interface. 


£45 /$45 
magpi.cc/2uf3kxq 
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Vibrant mini screen packs a lot of pixels into a small space - Phil King 


hile most small screens 
connect to the Pi’s HDMI 
socket, the HyperPixel is 
a HAT that plugs onto the GPIO 
pins. It comes pre-assembled, 

so no soldering is required. On 

a Pi Zero, it mounts straight on 
top for a flush fit. For other Pi 
models, an extra female header is 
supplied to raise the HyperPixel 
so it sits on top of the Pi’s USB 
ports. A rubber foot (to stick to 
the top of the Ethernet port) and 
a support bolt are also supplied to 
provide extra stability. 

Before you can use the 
HyperPixel, you’ ll need to install 
some software. Fortunately, as with 
most Pimoroni products, you can 
use a one-line installer command 
in the Terminal. To enter the 
command you’!] need to hook the 
Pi up to another monitor, or access 
it remotely via SSH. When the 
software has been installed, the Pi 
will only display to the HyperPixel, 
unless you revert the config. txt file. 


Once it’s all up and running, 
you’re sure to be impressed by 
the HyperPixel's performance. 
The 800x480 resolution matches 
the official Pi 7-inch touchscreen, 
and with a pixel density of 270 
ppl, the HyperPixel beats its rival 
3.5-iInch screens. The display 
looks seriously sharp with vibrant 
colours (18-bit for 262,144 
shades) and good viewing angles. 
There is some occasional colour 
banding when displaying 
fine gradients, but it’s hardly 
noticeable. With a frame rate 
of 60 fps, videos look superb - 
although we noticed a tiny bit of 
distortion at the right-hand edge 
when streaming YouTube videos 
(but not when playing those 
stored locally). 

That frame rate is down to 
the use of DPI (Display Parallel 
Interface). The downside to this 
is that the 18-bit colour uses 
18 GPIO pins, while the rest are 
needed for functions including 


syncing and two-point capacitive 
touch. [?C and SPI are also 
disabled. Naturally, this limits 
the screen’s usefulness for some 
projects. In addition, if you want 
to use PWM for fine control of 
the backlight brightness, you 
won’t be able to output audio via 
the Pi’s 3.5 mm jack. 


fast word 


While not suitable for 
projects requiring GPIO pins, 
the HyperPixel is ideal for 
use in a mini media centre, 
portable retro games 
console, camcorder (see 
magpi.cc/2tjrgNq), orasa 


touchscreen interface. Since 
the Raspbian desktop is too 
fiddly to control in miniature, 
you'll want to create your own 
custom GUI. Whatever you use 
it for, this is a stunning screen. 
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UNICORN 
HAT HD 


With its 
programmable 
16x16 RGB LED 
display, this 

is a great HAT 
that is easy to 
code and fun to 
use ina range 
of projects. 


£32 /S41 
magpi.cc/UniHATHD 
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A new multimedia add-on that brings lights and sound 
to a pi-top or a Raspberry Pi. Rob Zwetsloot takes a look 


e love the pi-top range 

of computers. They 
provide true PC or laptop 
conversion kits for the Raspberry 
Pi, customisable with plug-in 
modules and aimed at educational 
users. Usually these add-ons 

are designed to enhance the 
experience of using the pi-top, 
but that’s all changing with their 
latest and most ambitious add-on, 
the pi-topPULSE. 

It may be ambitious, but it is 
also very cool. From the top, it’s 
an unassuming white plastic 
square. It includes a 7x7 LED 
display under the plastic, plusa 
microphone and speaker. The PCB 
is visible on the underside, but it 
is lovely and well designed. 

On its own, it can be plugged 
into a pi-top using the special 
magnetic rails inside the slide-out 


compartment, but it can also be 


used as a HAT on the Raspberry Pi. 


You’ll need to plug in a header to 
the underside of the PULSE before 
popping it on the Pi, but it works 
with Raspbian after installing a 
single piece of software. 

It’s avery tight fit on the 
Pi. The case barely misses the 
Ethernet port, and the connectors 
for the pi-top hang over the 
board, increasing the footprint 
of the Pi. As an educational tool 
it is excellent, with a very robust 
Python library for creating light 
displays and games. 

The microphone and speaker 
give you access to other functions. 
The PULSE acts as a fully 
integrated speaker for Sonic Pi, 
and is even optimised for use with 
Amazon Alexa on the Raspberry 
Pi. There’s a great demo on the 


product page that shows how it 
can be used with Alexa. 

It is a little tricky to get your 
head around the programming, 
but there are plenty of examples 
that helped us figure out how to 
use everything. 

All in all, it’s one of the most 
fun HATs we’ve seen in a while, 
allowing users to explore many 
amazing project ideas. 


fast word 


An amazing idea with great 
execution — we just wish it 
was slightly easier to program. 


With a bit of practice you can 
create some astounding things 
with the PULSE. 
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CLEVER CARD KIT 


Waker 
days 


Providing 
you with 
hours of 
entertainment 
building 
projects that 
can read and 
write from 
13,5 MHz 
contactless 
RFID 


Smart cards 
Monk Makes 


£15/$20 
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CLEVER CARD KI! 


Rob Zwetsloot adds RFID tags to his projects with a set of rewritable 
contactless cards and this special add-on 


n this issue of The MagPi 
we have a tutorial on 
creating an automation 


reiated TF 


RAINBOW system with Bluetooth tags, using 

a) the Pi Zero W’s built-in Bluetooth 

KIT connection to detect Bluetooth 
signals (page 22). This project 

This kit doesn't ich d ‘1 bork 

use RFID, but is based on the concept of key 


it does allow cards and other contactless RFID 


you to interact 
with the 
environment, 
time, and the 
internet to 
learn about 
code and then 
make your own 
amazing things 


technology. Now, thanks to this 
kit, you can easily create your own 
Pi-based RFID projects. 

This simple, cheap kit allows 


Raspberry Pi. It comes with six 
RFID-compatible cards and an 
RFID key fob. Being a Monk Makes 
kit, it also comes with some other 


© 
£80/$103 
magpi.cc/2vXINwQ 
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goodies to help you play with 
your new project, including a 
push button and an RGB LED. The 
lovely printed booklet that comes 
with the kit includes instructions 
for projects that use the extra 
goodies, and takes you through 
the easy Python code needed to 
set up the reader. 


This project is based on the 
concept of key cards and other 
contactless RFID technology 


The book starts with some basic 
projects and finishes off with a 
special ‘Monopoly’ project, which 
allows you to assign money to 
each RFID card and play the game 
without using stacks of cash. 

It’s a wonderful little kit, and 
it’s so easy to use. The projects 
in the book require absolutely 


zero soldering — although if you 
want to make something a little 
more complex, you can always get 
your soldering iron out. It doesn’t 
require much extra software 
installation either, so we had the 
reader up and running in no time. 
Finally, the inclusion of the cards 
and key fob are very welcome — 
we already have some ideas for 
projects using these in the future. 

And did we mention that it’s 
only £15° That’s a bargain any day 
of the week. 


fast word 


A really fun kit idea from Monk 
Makes that does a great job of 
teaching you how to use RFID 


readers, and inspires you to go 
out and do much more with 
the technology. 
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Raspberry Pi for professional applications 


ik 


SU QUO 


Strato Pi enhances the Raspberry Pi and the Compute 
Module with hardware features that make them 
suitable for use in professional applications where 
reliability and service continuity are key requirements. 


CE/ROHS 
CERTIFIED REAL TIME HARDWARE 
CLOCK WATCHDOG DIN-RAIL 


Si 


RS-232 / 
RS-485 


WIDE RANGE 
POWER SUPPLY 


OP? 
LOO 
lono Pi is a versatile 1/0 module that 
combines digital and analog standard 


= ak eeee * 
interfaces with the powerful orca 
computing core of the Raspberry Pi. aE 

@ BESS 10 2.4 e 
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RASPBERRY PI 
BESTSELLERS 


A camera is just a piece of hardware. 
Vision lies in software - and understanding. 


LEARNING OPENCV 3 


Authors: Gary Bradski 

& Adrian Kaehler 
Publisher: O'Reilly 
Price: £59.99 
ISBN: 978-1491937990 
magpi.cc/2hGVLM4 


Targeting the C++ API, Kaehler 
and Bradski's near 1,000-page 
work covers every aspect of 
real-time image processing 
library OpenCV, as well as some 
useful insights into computer 
vision in theory and practice. 


VISION AND BRAIN: 
HOW WE PERCEIVE © 
THE WORLD 


Author: Dr James V Stone 
Publisher: MIT Press 
Price: £29.95 

ISBN: 978-0262517737 
magpi.cc/2ulRAqA 


A computational theory of 
vision. Dr Stone's enjoyable 
and accessible look at the how 
and why of animal and human 
vision will give you a fresh 
perspective on the subject. 


RASPBERRY Pl 
IMAGE PROCESSING © 
PROGRAMMING 


Author: Ashwin Pajankar 
Publisher: Apress 

Price: £14.99 

ISBN: 978-1484227305 
magpi.cc/2umpuj9 


Putting it all together on 

the Pi: a compact but useful 
introduction to Python-based 
image capture and processing 
on the Pi, with pillow, scipy, 
and matplotlib. 
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NUMSENSE! 


Authors: Annalyn Ng 
& Kenneth Soo 
Publisher: Annalyn Ng & 
Kenneth Soo 
Price: £23.99 
ISBN: 978-9811110689 
magpi.cc/2umfEOg 


Data science is 
everywhere (as is hype about 

data science), as intelligent analysis 
of petabytes of new data becomes 
essential to governments, business, 
charities, and anyone looking to 
make intelligent predictions. The 
field requires strong mathematical 
skills, but what about people who 
need to make decisions about 

data, but who are not Statisticians 
and programmers? 

Ng and Soo’s guide to Data 
Science for the Layman: No Math 
Added is a clear explanation of 
ten data analysis algorithms for 
supervised and unsupervised 
learning - plus one reinforced 


PYTHON IN 
A NUTSHELL 


Authors: Anna Ravenscroft, 


Alex Martelli, 
& Steve Holden 
Publisher: O'Reilly 
Price: £55.99 
ISBN: 978-1449392925 
magpi.cc/2ulYkoE ina a Nutshell 
Aon Rovenscot§ Sve Heder 


A long time in the 
making (the second edition 
was released more than a decade 
ago), the cover refers to this book as 
‘a desktop quick reference’ - and it 
is the place to look up queries about 
Python, the standard library, and 
many parts of the Python ecosystem 
- but the size of this edition (more 
than 700 pages) is a heavyweight 
indicator of Python’s growth. 
O’Reilly’s venerable nutshell 
series offers a comprehensive 
treatment of every topic — in this 
case Python for programmers 
coming from other languages, or 


learning example - preceded bya 
basic look at data selection. Each 
algorithm is illustrated witha 
well-chosen data example, which 
is examined with illustrative 
eraphs, clear text, and no 
mathematics, rounded off with 
a look at the limitations of the 
algorithm chosen. 

From soccer penalties and obese 
giraffes, to PageRank and social 
networks applied to geopolitics 
and weapons sales, Numsense!’s 
examples illustrate and illuminate, 
but the real clarity comes from the 
direct writing style, and the authors’ 
understanding of the subject matter. 
This book is not just for the non- 
technical reader - any programmer 
looking to understand data science 
and machine learning will quickly 
gain an appreciation of algorithms 
that other works introduce in a far 
less digestible form. 


Score 


those with a little Python who need 
to know more. Coverage is split 
between the basics (with plenty of 
detail on alternatives to standard 
CPython); core Python and 
the standard library; and 
a mixture of standard and 
extension libraries over topics 
such as databases, numeric 
processing, and dealing with 
testing and debugging. 
Treatment is always detailed 
enough to get the job done. 
Network and web protocols 
make up the penultimate 
section; and the book is rounded 
off with extending, embedding, 
packaging, and the issues arising 
between versions 2 and 3 of 
Python. This may not be the book 
you’ ll use to learn the language, 
but put it on your shelf and you’ 1] 
often reach for it as areference 
text throughout the time that you 
use Python. 


Score 
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ELECTRONICS 
COOKBOOK 


Author: Simon Monk 
Publisher: O'Reilly 
Price: £39.99 

ISBN: 978-1491953402 
magpi.cc/2umkUBo 


In the 1970s 
and 1980s, 
newsagents’ shelves 

were Stacked with titles like 
Everyday Electronics and Practical 
Wireless, and amateur electronic 
hardware knowledge would 

be applied everywhere from 

home hi-fi to DIY guitar pedals. 

A combination of pervasive 
computing and ready-made 
hardware devices costing pennies 
means modern Pi users are far 
more likely to be familiar with 
software than hardware. How 

to catch up on a mix of theory, 
component knowledge, and dozens 
of useful circuits? 


KOTLIN 
IN ACTION 


Authors: Dmitry Jemerov 
& Svetlana Isakova 
Publisher: Manning 
Price: From £20 (Amazon 
resellers only in the Uk) 
ISBN: 978-1617293290 
magpi.cc/2vgdw9D 


Kotlin is aJVM language 
from JetBrains, the people behind 
the IntelliJ IDEA Java IDE. Not 
the first language to attempt to 
fix the problems of Java (hello 
Scala!), but uptake has been swift, 
and we’ve heard praise for the 
language even from some notable 
Pythonistas. Kotlin is touted as 
a good replacement for Java in 
Android development — something 
of additional interest here, with 
Android Things running on the Pi3. 
This book is aimed squarely at 
Java developers: you don’t need 
to be a Java expert to benefit from 
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by . 


Enter the ever-useful Simon 
Monk, with a cookbook that has the 


potential to become another O’Reilly 


classic. True, you’ll need to make 
reference to the Errata page on 


the O’Reilly website, in particular 


for the first half dozen chapters; 
but this is a great collection of 
practical electronics know-how, 
nominally built around the needs 
of small board users, but essential 
for any learner. 
The recipe format is stretched 
a little in the early chapters, to 
introduce theory and the basics of 
discrete components, but soon the 
recipes become mini-projects in 
themselves, and potential building 
blocks for all manner of Pi-based 
constructions. For old hands, 
it’s nice to have all these circuits 
collected together - and your old 
reference books won’t have this 
one’s Pi and Python recipes. 


Score 


this very effective guide, but 
non-Java users should wait fora 
different Kotlin book. Jemerov and 
Isakova are Kotlin insiders. They 
make a persuasive case 
in the ‘What and Why’ 
chapter, before moving 
on to the basics of ‘how 
— emphasising the lack of 
boilerplate in examples 
such as declaring classes, 
and showing off the 
language’s type inference. 
Classes are expanded 
in a chapter which highlights 
the differences from Java in 
interfaces. Improved function calls, 
adding methods to Java classes or 
interfaces, lambdas, and Kotlin’s 
extensive type system round off the 
first half’s language introduction. 
The second half gets you building 
your own APIs, using higher 
order functions, and using deeper 
features such as DSLs. 


) 


Score 


ESSENTIAL READING: 
BEYOND FRAMEWORKS 


Frameworks can hinder understanding. Get to 
know the nuts and bolts of web development. 


Build your 
own AngularJS 


Author: Tero Parviainen 
Publisher: Teropa 
Price: £15.00 
magpi.cc/2vKuoWA 


BUILD YOUR OWN 


A deep dive into the workings of a web 
framework, guiding you to better skills, 
and confidence in your knowledge. 


Modern 
JavaScript 


Author: Various 

Publisher: Sitepoint 

Price: £5 or Sitepoint subscription 
magpi.cc/2vgEgH1 ® 


MODERN 
JAVASCRIPT 


Having trouble keeping up? Sitepoint's 
latest anthology is a quick introduction 
to the most important parts of the 

JS ecosystem. 


Go in Practice 


Authors: Matt Butcher & Matt Farina 
Publisher: Manning 

Price: £27.99 

ISBN: 978-1633430075 
magpi.cc/2vjoJBA 


Pattern-focused guide to the highly 
concurrent language that could solve 
your web app problems. 


Refactoring 
JavaScript 


Author: Evan Burchard 
Publisher: O'Reilly 
Price: £39.99 

ISBN: 978-1491964927 
magpi.cc/2vC59Gi 


Refactormng 
Javascript 


Refactoring and testing will turn 
bad code to good. Well-written and 
enjoyable read - strongly recommended. 


Inclusive 
Design Patterns 


Author: Heydon Pickering 


INCLUSIVE 


DESIGN PATTERNS 
Coding Accessibility Into Web Design 


Publisher: Smashing Magazine Rem np 
Price: £27.00 SEK 
ISBN: 978-3945749432 Mee 


magpi.cc/2viJlYp Lf 


Best practices for pages accessible toall  — ~~ 
users, reconceiving web design as code- 
not pixel-based. Essential reading. 
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AN INTERVIEW 


Project Things is a new framework involving Mozilla’s 
Web of Things, and is now available on the Raspberry Pi. 
What exactly does this mean? 


82 


he maker community was 

abuzz with excitement 

when Mozilla announced 
Project Things last month, so we 
sat down with Benjamin Francis 
from the development team to 
talk about exactly what it means. 
Here’s what he told us. 


Can you explain what 

Project Things is? 

Project Things is an experimental 
framework of software and services 
to help developers connect ‘things’ 
(physical objects in the real world) 
to the World Wide Web in a safe, 
secure and interoperable way. The 
project includes developing a ‘Web 


Things Cloud 


Things Gateway 


Things Framework 
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of Things’ gateway, which helps 
bridge existing IoT devices to the 
web; acollection of cloud services 
to help manage a large number of 
IoT devices over a wide geographic 
area; and a framework of reusable 
software components to help 
create loT devices which directly 
connect to the Web of Things. 

The first piece of the framework 
we’ve released is an early prototype 
of an open-source Web of Things 
gateway. Anyone can download 
the software image from Mozilla’s 
website and build their own Web of 


Things gateway using a Raspberry Pi. 


The gateway enables users to choose 
a unique web address for their 

home without any complex DNS 

or router configuration, by using a 
secure tunnelling service provided 
by Mozilla. The gateway can then be 
used to monitor and control existing 
smart home devices like ZigBee and 
Z-Wave smart plugs and sensors, 
and access them remotely via a 
unified web interface. 

Our initial demo showed how 
you can turn smart plugs on and 
off from a web app. We’re now 
working with the community 
to add support for new types 
of devices and protocols via an 
adapter add-on system, and 
developing new components like 
a rules engine which can be used 
to define automated rules for how 
individual ‘things’ interact with 
each other (e.g. having a light turn 
on when a sensor detects motion). 


Welcome 


Choose a secure web address 
for your gateway: 


subdomain igaleyl Eee) ae) gz 


Next 


moz://a 


Project Things is easy to set up 


Why the Raspberry Pi? 

The Raspberry Pi 3 is affordable, 
easy to get hold of, runs Linux, 
and has wireless LAN and 
Bluetooth built in. This makes it 
an ideal hardware platform for 
the initial use cases — and the 
initial audience of DIY hackers 
and makers we’re targeting with 
Project Things. We plan to support 
other hardware platforms in the 
future too, but the Pi was a great 
starting point for us. 


Do you find it difficult to convey 
exactly what the IoT is to people: 
People have diverse ideas about 
what the Internet of Things 

is, and there’s really no single 
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MOZILLA, IOT, AND THE RASPBERRY PI: AN INTERVIEW Community 


oz:lla 


lol 


accepted definition. It can 
range from sophisticated cloud- 
connected smart devices with 
artificial intelligence, to tiny 
RFID tags in smart packaging 
which give physical products an 
GENCY Cll CNS Mae nAeN, Se 
for inventory tracking or smart 
consumer experiences. 

What makes IoT particularly 
confusing for end users is that 
because the technology is still 


the World Wide Web and apply 
them to the Internet of Things. 
It’s about creating a decentralised 
Internet of Things by making 
Things linkable and discoverable 
on the web, and defining standard 
data models and APIs (application 
programming interfaces) to 
make them interoperable. 

To put it simply, it’s about 
giving Things URLs on the web. 

We’re working with the W3C 
(World Wide Web Consortium) 
to help define standards for 
a decentralised Internet of 
Things, including a standard 
Web Thing description format 
to describe Things, and APIs to 
communicate with them. Project 
Things is Mozilla’s open-source 
implementation of those 


The gateway enables users 
to choose a unique web 
address for their home 


in its infancy, there are no 
universally agreed standards for 
how connected devices should 
communicate. This means that 
there are lots of proprietary 
products and platforms available 
which can’t talk to each other, 
so it’s easy to get locked into 
a particular brand or cloud service. 
At Mozilla we want to help 
educate users about the security, 


privacy, and interoperability issues 


around new IoT devices, while 
helping to define new standards 
for a decentralised Internet of 
Things which is safe and secure. 


What is the Web of Things? 


The Web of Things is an effort 
to take the lessons learned from 


raspberrypi.org/magpi 


proposed standards, but like all 

web standards, anyone is free 

to implement the specifications 
themselves in the programming 
language of their choice. 


How can people get started: 

Go to 1ot.mozilla.org to download 
our Things Gateway software 
image and follow the instructions 
to flash the image onto an SD 
card. You can then plug the SD 
card into your Raspberry Pi, plug 
in USB dongles for any additional 
wireless protocols you want to 
Support, then access the gateway 
via your web browser to set up a 


secure web address for your home. 


You can pair devices like ZigBee 
and Z-Wave smart plugs with the 


Things Gateway 


Front End 
(HTML, CSS & JavaScript) 


Web Thing API 
(HTTPS+WSS) 


Back End 


(NodeJS) 


Z-Wave 
Adapter 


ZigBee 
Adapter 


OS 


gateway and control them from 
your browser using the built-in 
web app. 

Project Things is an 
open-source project and we 
really encourage community 
contributions. There are lots 
of ways you can contribute, 
such as building your own IoT 
device which uses the proposed 
standard Web Thing API 
(magpi.cc/2vMuYB9Q), creating 
an adapter to bridge an existing 
IoT protocol or device to the web, 
or hacking Project Things itself 
to help us develop Mozilla’s 
Web of Things implementation 
(github.com/mozilla-iot). 

We’re looking forward to seeing 
what the hacker and maker 
community can build with this 
software as it develops, and 
we’d love to hear about your 
DIY IoT projects! 


Mozilla IoT 
OO for Raspberry Pi -. 


Things Cloud 


TLS Tunneling Service 


— 
SAbbbAasbbbaddae 
- 
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FEATURE 


THE MONTHIN 


Everything else that happened this month in the world of Raspberry Pi 


For some reason, everyone’s been using their AIY Projects Voice Kits 


in phones and intercoms this month... 


Ke By ee a AN ay 
oh Aft qn ae 


Wea arlier in this very issue, you’ ll have seen an 


amazing project that uses the ATY kit from 

: issue 57 to hack an old-school intercom and 
——: turn it into a digital voice assistant. It’s a wonderful 

. project, and we always love seeing what Martin Mander 
is going to upcycle next. 

Strangely, everyone else has been having the same 
idea! We saw loads of toy phones, intercoms, and other 
voice-powered products upgraded using AIY kits. Here 
are some of our favourites. 


Kids’ smartphone 


Martin Mander’s intercom project is retro and lovely 
This one is a little mean but honestly, we laughed. This 
Fisher-Price phone is a true classic and we love the idea 
Another intercom? of giving it a hefty upgrade with AIY, complete with a 
massive glowing button in the centre. Would it be creepy 
if you made it sing while the eyes moved? Very probably. 


Already Martin is inspiring 
other makers. Here’s another 
intercom voice project in 

the works, this time using 
Amazon Alexa. One day we’ ll 
have to run a comparison 
between the different voice 
assistant platforms. Perhaps 
we should have a retro intercom 
competition to decide it? 
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Operator! 


More retro upcycling with this old-school phone, 
upgraded to incorporate an AIY kit. Dial zero 


to talk to the assistant and get answers to your Still waiting for an AIY 
everyday queries. We have visions of someone kit? They're coming, 
picking it up and putting it under their chin to ask we promise! The best 
for ounce-to-gram conversions while they mix way to find out more 
some batter, Nineties style. is to sign up to our 


mailing list - that way 
we can let you know 
as soon as they go on 
sale. You can sign up 
at magpi.cc/Email-me. 


Toucan play at that 


This one is just fun. It’s noise-activated, and the 
assistant voice really doesn’t match its appearance. 
Maybe you could mod it so it has a Gilbert Gottfried 
voice? It also moves about as it speaks, adding to 
the Coolness Factor™. 


z..¥ Joel Marquez Sig, Jacqui Garrad ® BEAK NA. Tt 
eS z _ } 


Shhh! Geniuses at work! I've got an HAF CHeMMIZL., FJIvA—FeBSD 
AWESOME team! using the a | 

#raspberryjam 

#raspberrypl 
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t doesn’t seem very long ago that Raspbian 
Jessie came out. The successor to the original 
version of Raspbian, Jessie brought us a lot of 


minor upgrades and visual overhauls that are nowa 


normal part of the Raspbian experience. 
New Debian releases happen roughly every two years. 
Jessie came out in September 2015, so it’s now time for 


Raspbian to upgrade to Stretch. The major upgrades this 


time are happening below the surface, so you shouldn’t 
notice many differences when you’re using the desktop. 
What you will find is upgraded software, including 
Chromium, and Bluetooth audio via ALSA, along with... 
SONIC PI 3.0.1 
Sonic Pi3.0 boasts a lot of new features, including: 

ig 


Time State a powerful new time-based 
deterministic shared memory system 


We got a massive Raspbian update this 


MIDI for i f MIDI 
month — here’s what you need to know Soi Sans a ni aA 
: OSC rt f di d ivi 
about the latest Raspbian release Bete eee ae 
messages on the network 
= = Live Audio for getting multiple streams of audio 
orm gryyen are Nae with Ranger Pt- Charman z : into Sonic Pi 


Multi-channel — for outputting multiple streams 
audio out of audio 


Audio Buffers __ for internal recording of audio, 
enabling the creation of loopers 


SEE THE BLOG ARCHIVE 


SCRATCH 2 SENSE HAT EXTENSION 


Scratch was upgraded in the last Jessie release to 
Scratch 2, and this upgrade gives it the ability to 
interact with the Sense HAT. Hopefully this will 

introduce Scratch users to Astro Pi! 


Debian 
releases are 
named after Toy 
Story characters. 
Stretch is an 
octopus toy from 
Toy Story 3, about 
whom you've 
probably forgotten 
after your heart 
shattered at 

the end... 


oe 
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THIS MONTH IN Pl BGT 


KICKSTART THIS! 


Raspberry Pi projects you can crowdfund this month 


BEST OF THE REST 


o—6 
Sad CNC WOOD 
» fy BURNER 


BOBOP 
A 


BOBOP is billed as ‘the first smart robot for parents’. 
It looks a bit like the Mira bot project, featured earlier 
in this issue, although this one apparently keeps an 
eye on your kids. According to the creators, it was 
prototyped heavily with a Raspberry Pi, which is still 
being used as one of its main computers. You should 
just have enough time to give it a look before it ends. 


Lil 
JEEP ACCELEROMETER 


rm 
a 


Smarti Pi Flex 


Raspberry Pi Zero camera arm 


AUTOMATIC VIDEO WALL 


—_— 


-_ 
magpi.cc/2w6n5JE - 


SMARTIPI FLEX 


This is a neat project. It’s a special case for a Pi Zero 
and the Raspberry Pi Camera Module, with a flexible 
arm that holds the camera in a fixed position. It’s a 
simple but great idea, allowing you to make some really 
cool camera-based projects. The campaign will have 
just finished by the time you read this, but hopefully it 
hit its target and you can pre-order one for yourself! 
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Educators gather in Cambridge to find out how they can take their Code Clubs further 


Peter 

Onion’'s demos 
drew crowds of 
people wanting 
to know more! 


raditionally, Code 
Clubs are places for 
educators to teach kids 
about computer science. There 
are thousands of them around 
the world and they’ve helped 
countless students improve 
their computing skills through 
fun activities. 
In Cambridge, in late July, 
a different kind of Code Club 


meeting took place. Volunteers 
and educators who run Code 
Clubs, along with prospective 
Code Club hosts, visited Code Club 
(and Raspberry Pi!) HQ to attend 
some talks, get to know other 
Code Club volunteers, and find out 
how to improve their Code Clubs. 
“At the event in Cambridge, 
everybody had a chance to get 
hands-on with Code Club projects 


using pi-tops,” said Sarah 
Sheerman-Chase, Participation 
Manager at Code Club. “Peter 
Onion, who is a volunteer at a club 
in Essex, demonstrated physical 
computing with micro:bits. 

There was also plenty of time for 
networking, and the opportunity to 
meet the team, including Mickey 
Day, the Code Club Coordinator for 
the East of England, and myself.” 
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Plenty of demos were on hand 
for volunteers to try out and 
see what students could learn 


While this was a relatively 
small event held in a conference 
room, it was pretty packed and 
full of excited Code Clubbers 
wanting to learn more and share 
their experiences. We saw many 
people getting to grips with some 
of the example projects on the 
pi-tops in the room, while others 
were wowed by Peter Onion’s 
computing demos. 


CODE CLUB MEETUP 


222222222227222212114 


SPLLLILLLILI7 


thought it was a good way of 
engaging them beyond Scratch. 
Now we’ve finished this academic 
year and they’ve all said how much 
they’ve enjoyed it. The volunteers 
are doing fantastic work.” 

We always hear about Code 
Clubs being constantly full, and 


how kids really enjoy them, and He also helps out in the Code 
Anne’s club was no different. Club sessions, revealing that 
“We’ve had a very successful their club has a far better gender 


ratio than the tech workforce as 
a whole, with girls making up 


Everybody had a chance to pee eer ont eee 
their attendees. 
gel hands-on with Code Club He feels the courses have a 


projects using pl-tops great deal of choice in them, 


A sea of volunteers 
We spoke to Anne Worthington, 
who runs a Code Club at 


Cambridge Central Library, which 


has become very popular. 

“It was a bit slow to begin 
with,” Anne admitted to us. 
“Then, as soon as people knew 
what it was about, we started 
filling up a waiting list and 
we managed to satisfy those 
requests to get on board.” 

It began with a taster session, 
held in partnership with a sister 
event in Huntingdon. The club 
eventually started in the middle 
of the school term with a focus on 
Scratch and Python. 

“Those who had done Scratch 
could move onto Python,” 
explained Anne. “The volunteers 
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allowing every participant to 
create projects based on their 


year, with a full complement of own interests. 

14 or so children at each session. After munching on some pizza, 
A bit up and down with holidays it was time to head home, but 
and family life, but it was just everyone seemed to leave with 
joyous seeing how much better new ideas and inspirations to 

the children got at the activities. Stal Om la prove tien Code Glube. 


We have similar Code Club 
activities running in Huntingdon 


and St Neots, and we’re looking START A 


to expand to libraries out in The 

Fens as well.” CODE CLUB oe 
Choose your 

own adventure 

One of the volunteers for the 
Cambridge Central Library Code 
Club, Krishna Kumar, helped 
develop learning resources for 
the micro: bit, which the club 
plans to use — a hot topic of 
discussion at the event. 


You don't have to attend 


meetups to start your own 

Code Club - you can find 

all the information you need on the Code 
Club website at codeclub.org.uk. Learning 
resources are free - all you need to do is 
find a venue with computers! 
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COMMUNITY PROFILE 


DAVE 
AKERMAN 


High-altitude balloonist and master of 
LoRa, Dave likes to send Pis as high as 
the atmosphere will allow 


he pinned tweet on Dave the BBC, Dave is best known in the 
Akerman’s Twitter account Raspberry Pi community for his 
shows a table displaying use of the small computer in every 
the various components needed payload, and his work as a tutor 
for a high-altitude balloon (HAB) alongside the Foundation’s staff at 
flight. Batteries, leads, a camera Skycademy events. 

and Raspberry Pi, plus an unusually Dave has dedicated many hours 
themed payload. The captionreads and many, many more miles to 
‘The Queen, The Duke of York, and _ assisting with the Foundation’s 
my TARDIS’, and sums up Dave’s Skycademy programme, helping 
maker career in a heartbeat. to explore HAB with educators 


Category: High-altitude 


Walloon: Though writing software for from across the UK. Using a 
: industrial automation pays the Raspberry Pi and various other 
Heke SE URES bills, the majority of Dave’s time pieces of lightweight tech, Dave, 
SLOP FEUES Cn aS is spent in the world of HAB and and Foundation staff member 
Website: daveakerman.com the ever-growing community James Robinson, explored the 
twitter.com/daveake that encompasses it. And, while incorporation of high-altitude 
he makes some money sending ballooning into education. Through 
Below Dave continues tohelp business-themed balloons to near- Skycademy, educators were able 
Nee eee ee nace fore nellikesote Sandia to learn new skills and take them 
and having a good time 
exploring the atmosphere Animations, Confused.com and to the classroom, setting off their 


Dave doesn't just launch balloons for fun. 
With clients such as the BBC and Heston 
Blumenthal, he's launched all manner of 
items into space... including a potato! 
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own balloons with their students, 
and recording the results on 
Raspberry Pis. 

But education isn’t the only 
reason for Dave’s involvement 
in the HAB community. As 
with anyone passionate about a 
specific hobby, Dave strives to 
joie recoils, nie ies recent 
record-breaking flight took place 
on 13 August 2017, as Dave’s 
Raspberry Pi Zero HAB sent home 
the highest images taken by any 
amateur high-altitude balloon 
launch. At 43,014 metres, no other 
HAB balloon has provided images 
from such an altitude, and the 
lightweight nature of the Pi Zero 


HIGHLIGHTS 


definitely helped, as Dave went 
on to mention on Twitter a few 
days later. 

Dave first fell in love with high- 
altitude ballooning after coming 
across the hobby as a video shared 


DAVE AKERMAN 


progression. Throw in his coding 
skills from learning to code ona 
Teletype and it’s no wonder he 
was ready and eager to take to the 
skies, so to speak, and capture the 
curvature of the Earth. What was 


As with anyone passionate 
about a specific hobby, Dave 
Strives to break records 


on a photographic forum. Witha 
lifelong interest in space thanks 
to watching the Moon landings as 
a boy, plus a talent for electronics 


and photography, it seems a natural 


Dave's most recent flight broke a new record. On 13 August 2017, his HAB 
payload was able to send back the highest images taken by any amateur flight 
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so great about using the Raspberry 
Pi was the instant gratification 
gained when receiving images 
in real-time as they were taken 
during the flight. While other 
devices could operate a camera 
and store the photographs for 
later retrieval, Dave was able to 
transmit them back down to Earth 
and check the progress of his 
balloon while attempting to break 
records with a flight. 
High-altitude ballooning isn’t 
the only part of Dave’s life that 
incorporates a Raspberry Pi. 
Having “lost count” of how many 
Pis he has running tasks, Dave 
has also created radio receivers 
for APRS (ham radio data), ADS-B 
(aircraft tracking), and OGN 
(gliders), along with a time-lapse 
camera in his garden, and a few 
more for tinkering purposes. 
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EVENT CALENDAR 


Find out what community-organised, Raspberry Pi- 
themed events are happening near you... 


Want a Raspberry Jam in 
your area? Want to start one? 


RASPBERRY 


JAM JOBURG 
Email Ben Nuttall about it: | | | 
ben@raspberrypi.org : 8 

7 
> 
= 
UGIGUEIGISE TE. De WEIN rs REGULAR EVENTS 
TECHNO JAM JAMMING CORNWALL TECH JAM 
When: Saturday 9 September IN MARLBOROUGH When: Saturday 9 September 
Where: Southport College, When: Saturday 16 & 23 September Where: Cornwall College Camborne, 
Southport, UK Where: Marlborough Library, Isvevoheniielal, Ul 
technojam.uk Marlborough, UK cornwalltechjam.uk 
An event for people who are magpi.cc/2xa25yq For all ages and abilities: ask 
interested in all forms of Drop in to Marlborough Library on questions and learn about 
technology to come together Saturday morning to see Raspberry programming in Scratch, Python, 
and share their knowledge. Pis being used in a variety of ways. Minecraft, and much more. 
GUILDFORD RASPBERRY HULL RASPBERRY JAM 
RASPBERRY JAM JAM JOBURG When: Saturday 9 September 
When: Saturday 16 September When: Saturday 16 September Where: Hull Central Library, 
Where: Guildford Library, Where: Entelect, Johannesburg, ele ML OLS 
Guildford, UK South Africa magpi.cc/2wgiUv8 
mMagpi.cc/2xawKf1 mMagpi.cc/2wgrJ VW There’ll be chances to get hands- 
Learn about Raspberry Pis, get You’ll get the opportunity to on with digital making activities 
help from others, show off demonstrate your Pi project through workshops, anda 
your projects, and meet other and discuss it with other like- hackspace area to share projects and 
Raspberry Pi fans. minded Pi enthusiasts. give lightning talks. 
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| / JAMMING 
At IN MARLBOROUGH 


MANCHESTER 
RASPBERRY JAM 


GUILDFORD 
RASPBERRY JAM 


5 CORNWALL TECH JAM 


MANCHESTER 

RASPBERRY JAM 

When: Saturday 9 September 
Where: The Shed, Manchester, UK 
magpi.cc/2wgeAMp 

A very long-running Jam that 
celebrated its fifth birthday in June 
of this year, finally back from its 
Summer hiatus. 
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RASPBERRY JAM 

@ PI TOWERS 

When: Saturday 16 September 

Where: Raspberry Pi HQ, 
Camibnidses Wik 

magpi.cc/2wgBoxb 

A family-friendly event where 

everyone is welcome, providing 

coding and digital making activities 

for children and adults. 


WE'VE HIGHLIGHTED SOME OF 

THE AREAS IN NEED OF A JAM! 

CAN YOU HELP QUT? 
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RASPBERRY JAM ADVICE 


FINDING ; , 
VOLUNTEERS », °° 


ow SE 
“You'll find that a lot of the people who 4 > ma 
attend your first Jam will become your & © 
future volunteers” a\% 
Mike Horne ra 
; (i) 
Cambridge Raspberry Jam e RASPBERRY r 
@ JAM) . 
Every Raspberry Jam is entitled to apply bad 
. . . G U | D E B @) 0 ‘ 
for a Jam starter kit, which includes 


magazines, printed worksheets, stickers, 
flyers, and more. Download the book here: 
magpi.cc/2qSDHfQ. 
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You can 

find out how to 
burn an SD card 
with Etcher ona 
PC by following 
our video tutorial: 
magpi.cc/2sj7leN 


LETTERS 


( 


Magazine 


Etcher on Pi 

I followed the instructions in the article about 
how to use Etcher with Raspberry Pi SD cards. 
However, I am unable to make it work. I used 

the code below: 


cd Downloads 
chmod a+x Etcher-linux-x64.AppImage 
./Etcher-linux-x64.AppImage 


I get an error and I am unable to make Etcher 
run. The error is: ‘cannot execute binary file: 
Exec format error’. Can you help? 

CuteCobra 
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Maker Faire New York 

I see The MagPi attends some events in the 

UK, such as the birthday parties and Pi Wars. I 
understand you’re a UK-based magazine. However, 
I was wondering if your team would be making 

an appearance at a US Jam or event of some sort? 
Would love to meet you guys! 

Angela L 


We don’t exhibit at events often enough, really! It’s fun 
and great to meet people, but it does take a lot of time. 
Having said that, if you’re at Maker Faire New York this 
September, some MagPi team members will be helping 
out at the Raspberry Pi stall, so if you’re attending you 
can come and see us. Even if you can’t get to New York, 
you can usually find some MagPi-related goodies on 
Raspberry Pi stalls at events across the USA. 


Unfortunately, Etcher doesn’t work on the 
Raspberry Pi: the packages you can download for 
Linux are either x86 or x86_64, which are meant 
to TUM ona normal PC =i tus case a normal PE 
running Linux. 

You can’t burn a downloaded Raspbian image 
to another SD card on the Raspberry Pi in the same 
way as using Etcher on a PC. However, with the 
SD Card Copier tool in Raspbian, you can make a 
copy of your current SD card to another SD card 
connected via a USB card reader. The software 
will guide you through the process. 

The article this reader is referring to can be found 
here: magpi.cc/2fZkyJD. 


GETTING THE AIY 
PROJECTS VOICE KIT 


We're still getting emails from a lot of people asking 
how they can get their hands on issue 57 or the AIY 


Projects Voice Kit that came with it. We're adding 

a boxout here to remind everyone that the kit will 

be going on sale on its own soon. To find out when 
the kits will be available, sign up to our mailing list 

at magpi.cc/Email-me. That way, we can let you know 
as soon as we have a date for the release of the Kits. 
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FROM THE FORUM: 


The Raspberry Pi Forum is a hotbed of conversations and problem-solving 
for the community. Join in via raspberrypi.org/forums 


O 


have just received the latest The MagPi #60, Is the latest one safe to use? How do I know it’s safe? 
and was delighted to find the attached Many thanks, 
Raspberry Pi Desktop x86 DVD. Unfortunately CraigT 

I then realised I hadn’t bothered adding a DVD drive 


to my new computer. My intention was to run it in For future reference, you can easily find the ISO of 

VirtualBox, so ideally I just need an ISO image. the latest x86 Raspberry Pi Desktop build by going 
Where would the best place be to download the to rpf.io/x86, set up by Raspberry Pi Community 

latest version of the ISO image (happy to do so as Manager Ben Nuttall. The one you pointed to in the 

a torrent)? forum thread was the latest version. As a general rule, 
Quite a few blogs from last year point to another if they’re hosted on the Raspberry Pi website, they’re 

image but I found a different one that seems to be safe to use. If they’re beta release or some other form 

more up to date. of non-stable release, they will be labelled as such. 


WD PIDRIVE NODE ZERO 


Build your own mini DLNA + Samba file server, wireless 
mobile storage device, a Pi Music Box with local storage 
and so much more. 


Includes: 

¢ 314GB WD PiDrive, Raspberry Pi Zero, 
and custom adapter board 

¢ SD card with starter software 

e Mini HDMI adapter cable 


@ WD LABS Learn more at wdlabs.io/mp60c 


Western Digital, WD, the WD logo, WDLabs, and the WDLabs logo are registered trademarks or trademarks of Western Digital Corporation or its affiliates in the U.S. and/or other c ntries, Raspberry Pi is a trademark of the Raspberry Pi Foundation. OSD is a trademark of SD-3C, 
LLC. The term HDMI is a trademark or registered trademark of HDMI Licensing LLC in the United States and other countries. All other marks are the property of their respective owners. As used for storage capacity, one gigabyte = one billion bytes. Total ac secaastoks capacity varies 
depending on operating environment, Product specifications subject to change without notice, Pictures shown may vary from actual product. © 2017 Western Digital Corporation or its affiliates 


@ @ code 
club 


j 
START A CODE CLUB 
IN YOUR SCHOOL! 


Code Club is a network of volunteers and educators who 
run free coding clubs for young people aged 9-13. 


Our aim is to inspire the next generation to 
get excited about computer science and digital making. 


“We use Code Club's fun educational resources to runa 
weekly after-school club for Year 7 and Year 8 pupils. The 
students benefit considerably from the extra challenge!” 


Karen Dadd, Computing Teacher 


M4 Code Club is free 


4 Code Club provides step-by-step guides for 
Scratch, Python, HTML, and Sonic Pi 


M4 Code Club helps children develop skills including 
logical thinking, creativity, and resilience 


We have over 6000 clubs across the UK teaching 
more than 80,000 young people to code—come and join us!" 


Find out more at www.codeclub.org.uk 


Code Club is part of the Raspberry Pi Foundation. Registered Charity Number 1129409 65 
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www. lhePiHut.com 


WIN! 


RASPBERRY PI 3 


RETRO 


GAMING BUNDLES 


We’ve got three Raspberry Pi 3 retro gaming 
bundles up for grabs, worth £65 each. 


Not only that, 15 lucky runners-up will get 
a SNES-style Raspberry Pi game pad. 


These great prizes are courtesy of The Pi Hut: 
thepthut.com 


Learn more about the retro gaming bundle at 
magpi.cc/2uY6K9Y 


Terms & Conditions 


Competition opens on 30 August 2017 and closes on 28 September 2017. Prize is offered to participants world-wide aged 13 or over, except employees of the 
Raspberry Pi Foundation, the prize supplier, their families or friends. Winners will be notified by email no more than 30 days after the competition closes. By entering 
the competition, the winner consents to any publicity generated from the competition, in print and online. Participants agree to receive occasional newsletters from 
The MagPi magazine. We don't like spam: participants’ details will remain strictly confidential and won't be shared with third parties. Prizes are non-negotiable and 


no cash alternative will be offered. This promotion is in no way sponsored, endorsed or administered by, or associated with, Instagram or Facebook. 
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Column = THE FINAL WORD 


MATT RICHARDSON 


Matt is Raspberry Pi's US-based product evangelist. Before 
that, he was co-author of Getting Started with Raspberry Pi 


and a contributing editor at Make: magazine. 


, RASPBERRY PI AND 
’ MICROCONTROLLERS: 


. A POWERFUL PAIRING 


Matt Richardson’s take on how two popular technologies work together 


hen I first joined the maker movement in 
2010, microcontrollers such as Arduino were 
already an indispensable tool for making 
things with technology. I used Arduino in many of 
my projects because it was So easy to program, and 
there was a ton of easy-to-follow examples and 
community support available. At the time, some of 
my projects involved operations such as saving data 
and hosting a web server, which would push any 
microcontroller of that era to its limits. 

Therefore, when maker-friendly single-board 
computers like Raspberry Pi came onto the scene, 
I started to think a lot about how their powerful 
processors would be useful for more advanced 
projects. Coupled with the on-board general- 
purpose input and output pins, it meant makers had 
new tools at their disposal to push the boundaries of 
what’s possible for their projects. 

There’s a lot of overlap in the functionality of 
a single-board computer and a microcontroller. 
Both have the ability to run code and interface with 
electronics. The strength of a single-board computer 
lies in its ability to do ‘high-level’ tasks, such as 
running web servers, writing to databases, capturing 
photos, executing computer vision algorithms, 
playing audio and video, and so on. Microcontrollers 
have their strengths as well. For example, they’re 
good at sending signals with precise timing, which 
is important for controlling some types of motors or 
addressable LEDs. Other advantages include their low 
energy consumption, their quick start-up time, and 
often they have built-in analogue input capability. 


Working together 

As a maker, having both microcontrollers and single- 
board computers in your toolbox means you can 
accomplish a broader range of projects. Choosing 

the right type of board based on your project’s needs 
is an important skill for a maker, but that doesn’t 
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necessarily mean that you’|l choose one or the 
other. A single-board computer can work well with 
a microcontroller in a unified project. 

A simple serial communications connection 
between a Raspberry Pi and Arduino means that the 
two boards can talk to each other and pass data back 
and forth. For example, if you were making your 
own pen plotter, you may have a microcontroller 
controlling the stepper motors which move the pen. 
The data could be fed to the microcontroller bya 
single-board computer, which shows a user interface 
on a screen or via a built-in web server. 


Their strong 
interoperability opens 
up so many possibilities 


The way that the two platforms work together 
doesn’t stop there. A microcontroller isn’t very 
useful if you don’t have a computer to write the code 
and upload it to the board. Luckily, the Arduino’s 
development environment runs nicely on Raspberry 
Pi’s Raspbian operating system. So even if your 
project doesn’t call for anything more than a 
microcontroller, why not use your Raspberry Pi 
to program it? 

Contrary to what some may believe, 
microcontrollers and single-board computers aren’t 
competitors, but partners. While there’s a lot of 
overlap in the functionality of both types of devices, 
they’re both great tools to have in your maker toolbox. 
Their strong interoperability opens up so many 
possibilities for rather complex projects. When you 
make with both microcontrollers and single-board 
computers, the whole is greater than the sum of the 
parts — and that makes them a powerful pair. 
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Cana 
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A Wiley Brand 


Build your own credit card 
sized computer 


Get started with Programming 
St Up a Media Center 
Make simple electronic ci reuits 


Raspberry pj board and case 

fie ‘Upply and HOM) cable 
ré-Programmed Memory Card 

nin 40 electronic Parts 

SSP berry Pi Kit Far Dummigs Booklet 


ee 


Available in Europe 
Available for worldwide shipping at: through RS Components 


$89” £69°° 


US DOLLARS EXCLUDING VAT 


Raspberry Pi is a registered trademark of the Raspberry Pi Foundation. 
For Dummies and the Dummies Man logo are trademarks or registered 
trademarks of John Wiley & Sons, Inc. Used under license. RS logo is 

a registered trademark of RS Components Ltd. CanakKit is a registered 
trademark of Cana Kit Corporation. 


ELECTRONIC KITS e ELECTRONIC PARTS e RASPBERRY PI ¢ ARDUINO 


